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RUN-TIME SYSTEM 

These books come with every system: 




Installation Guide 

Part Number: 690-24096-nnn 
• Operating System installation 
Upgrade procedure 




System Administrator’s 
Guide 

Part Number: 690-*23415-nnn 

• Sysadmsh 

• Security 

• System tuning, troubleshooting 

• Peripherals 

• Virtual Disks 




User's Guide 

Part Number: 690-23408-nnn 

• Vi, ed, mail, awk, sed 

• Shells: sh and csh 

• Job scheduling commands 




User’s Reference (C, M, F) 

Part Number: 690-2341 4-nnn 
(also provided online with each 
operating system) 

• (C) Commands 

• (M) Miscellaneous files and 
commands 

• (F) File formats 




System Administrator’s 
Reference (ADM, HW) 

Part Number: 690-234 16-mn 
(also provided online with each 
operating system) 

• (ADM) Administrative 
commands 

• (HW) Hardware information 



These books may be ordered separately: 

Using the AOM 
Menu System 

Part Numbers: 690-238 14-nnn 

• Easy-to-use menus to use 
programs 

• Menu manager to add, 
update, remove menus 



Tutorial 

Part Number: 690-23407-mn 

• Basic concepts and tasks 
Files and directories 

• Utilities 



International Operating 
System Guide 

Part Number: 690-238 1 0-nnn 

• Character sets 

• 7-bit vs. 8-bit characters 



DEVELOPMENT SYSTEM 

Set Part Number: 690-23417-000 




Programmer’s Reference 
(CP.S) 

• (CP) Programming commands 

• (S) System services, library 
routines 




Programmer’s Guide 

• Lex, lint, yacc 

• sees, make 

• Extended Terminal 
Interface (ETI) 

• Sdb, adb 

• Shared libraries 

• File and record locking 




C Language Guide 

• C User's Guide 

• C Language Reference 




Library Guide 

• C Library Guide 

• XENIX Development and 
Portability Guide 

• International Development 
Guide 




Developer’s Guide 

• DOS and OS/2 Development 
Guide 

• STREAMS Primer 

• STREAMS Programmer's Guide 

• STREAMS Network 
Programmer's Guide 



CodeView and Macro 
Assembler User’s Guide 

• The CodeView Debugger 

• Macro Assembler User's Guide 




Device Driver Writer’s Guide 

• Writing, compiling, and linking 
drivers 

• SCSI drivers 

• STREAMS and line disciplines 

• (K) Kernel routines 



To order any of the above manuals, call 408/434-6688, ext. 3004 and give the 
manual title and part number. 





Operating System Documents 
for Different Audiences 



As shown on the previous page, Altos offers many manuals with Altos UNIX System V — the manu- 
als you receive will depend on your configuration. To help you decide which manuals are best 
suited to your needs, we have listed below the manuals according to three broad groups of users. 

These lists are only suggested starting points in your search for information. They are not meant to 
imply that certain users should not read certain manuals. Find the user group that best applies to 
you, and use its list of manuals as a starting point for your reading, from which you can move on to 
other manuals. 

Note that every Run-time System includes five manuals: the Installation Guide ^ the User’s Guide, 
the User’s Reference, the System Administrator’s Guide, and the System Administrator’s Refer- 
ence. The Run-time System reference pages that describe the C, M, F, ADM, and HW commands 
(“man pages”) are provided online as well. If you have the Development System, all manuals 
listed under “For Programmers:” come with your operating system. (All Development System 
reference pages are also provided online.) To order additional manuals, call (408) 434-6688, exten- 
sion 3(X)4 and give the manual title and part number. 



For General Users (especially Beginners): 

Tutorial 
User’s Guide 

User’s Reference (C, M, F) 

Using the AOM Menu System 

For System Administrators (and Advanced Users): 

Installation Guide 

System Administrator’s Guide 

System Administrator’s Reference (ADM, HW) 

International Operating System Guide 

Programmer’s Reference (CP, S) 

For Programmers: 

Progi*ammer’s Guide 
Programmer’s Reference (CP, S) 

C Language Guide 
Library Guide 
Developer’s Guide 

CodeView and Macro Assembler User’s Guide 
Device Driver Writer’s Guide 




Preface 



Throughout the documentation, a given command, routine, or file is 
referred to by its name and a section (in parentheses). For example, the 
programming command cc, is listed as cc(CP), which indicates that cc is 
described in the Programming Commands (CP) section. 

There is a total of twelve reference sections in Altos UNIX System V, in 
different volumes of the Operating System and the Development System 
documents. (These reference sections are often called manual pages ^ or 
just man pages, in short.) For example, the cc(CP) command mentioned 
above is located in the CP section found in the Programmer's Reference . 

This document, the User's Reference (C, M, F), contains the following 
three reference sections: 



Section Description Volume 



C Commands - used with the User’s Reference 

Operating System. 

M Miscellaneous - information used User’s Reference 

for access to devices, system 
maintenance, and communi- 
cations. 

F File Formats - description of User’s Reference 

various system files not defined in 
section M. 



The following table lists the remaining reference sections, the type of 
commands they contain, and in which document each is located. 




Section 



Description 



Volume 



ADM 


Administrative Commands - used 
for system administration. 


System Administrator’s 
Reference 


CP 


Programming Commands - used 
with the Development System. 


Programmer’s Reference 


DOS 


DOS Cross-development 
subroutines and libraries 


Developer’s Guide 


HW 


Hardware device manual pages - 
information about hardware 
devices and device nodes. 


System Administrator’s 
Reference 


K 


Kernel routines - used for writing 
device drivers. 


Device Driver Writer’s 
Guide 


NSL 


Network Services Library - used 
with the STREAMS System. 


Developer’s Guide 


S 


System Calls and Library 
Routines - available for C and 
assembly language programming. 


Programmer’s Reference 


STR 


STREAMS manual pages 


Developer’s Guide 


XNX 


XENIX cross-development 
manual pages 


Library Guide 



The alphabetized table of contents following this preface lists all Altos 
UNIX System V commands, system calls, library routines, and file 
formats. In addition, in the front of each individual reference section there 
is an alphabetized list of all the manual pages contained in that section. 

The permuted index, found at the end of the User's Reference , and the 
end of the Programmers Reference, is useful in matching a desired task 
with the manual page that describes it. It too is an organized list of a 1 
Altos UNIX System V commands, system calls, library routines, and file 
formats, but organized according to function, not alphabetically. 

Note that some pages in the Operating System documents refer to 
“include” files that are actually part of the Development System. 




Alphabetized List 

Commands, Systems Calls, Library Routines and File Formats 



300 300{C) 

4014 40l4{O 

450 450(C) 

86rel 86rel(¥) 

exit exit(S) 

a.out a.out(F) 

a641 a64l(S) 

abort abort(S) 

abs abs(S) 

accept accept (ADM) 

access access (S) 

acct acct (ADM) 

acct acct(¥) 

acct acct(S) 

acctcms acctcms (ADM) 

acctcom acctcom (ADM) 

acctdisk acct (ADM) 

acctdusg acct (ADM) 

acctmerg acctmerg (ADM) 

accton acct (ADM) 

accton accton(ADM) 

acctprc acctprc (ADM) 

acctprcl acctprc (ADM) 

acctprc2 acctprc (ADM) 

acctsh acctsh(ADM) 

acctwtmp acct (ADM) 

acos trig(S) 

adb adb(CP) 

add.vd add,vd(ADMi) 

addxusers .... addxusers (ADM) 

adfmt adfmt (ADM) 

admin admin (CP) 

alarm alarm(S) 

aom aom(M) 

ar ar(CP) 

ar ar(F) 

archive archive (F) 

ascii ascUQM) 

asctime ctime (S) 

asin trig(S) 

asktime asktime (ADM) 



assert assert (S) 

assign assign(C) 

asx asx(CP) 

at at(C) 

atan trig(S) 

atan2 trig(S) 

atcronsh atcronsh(ADM) 

atof atof(S) 

atof strtod(S) 

atoi atoflS) 

atoi strtol(S) 

atol atof(S) 

atoi strtol(S) 

audit audit (ADMl) 

auditcmd auditcmd (ADM) 

auditd auditd(ADM) 

auditsh auditsh(ADM) 

authcap authcap(F) 

authck authck(ADM) 

auths auths(C) 

authsh authsh(ADM) 

authsh authtsh(AJyM) 

autoboot autoboot(ADM) 

awk awk(C) 

backup backup (ADM) 

backupsh backupsh(ADM) 

badtrk badtrk(ADM^ 

banner banner(C) 

basename basename(C) 

batch at(C) 

be bc(C) 

bcheckrc 6rc (ADM) 

bdiff bdiff(C) 

bdos bdos{DOS) 

bessel bessel(S) 

bfs bfs(C) 

boot Z?aat(HW) 

bre Z?rc(ADM) 

brk sbrk(S) 

brkctl brkctl(S) 

bsearch bsearch(S) 
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cal cal(C) 

calendar calendar (C) 

calloc malloc(S) 

cancel (p(C) 

captoinfo captoinfo (ADM) 

card_info card_info(F) 

cat cat(C) 

cb cb(CP) 

cc cc(CP) 

cd cd(C) 

cdc cdc(CP) 

cdrom cdrom(lPW) 

ceil floor (S) 

cflow cflow (CP) 

cgets c^^r^(DOS) 

chargefee acctsh (ADM) 

chdir chdir(S) 

checkaddr .. checkaddr(ADMi) 

checklist checklist (F) 

checkmail checkmail(C) 

checkque checkque (ADM) 

checkup checkup (ADM) 

chg_audit .... chg audit (ADM) 

chgrp chgrp(C) 

chmod chmod(C) 

chmod chmod (S) 

chown chown(C) 

chown chown(S) 

chroot chroot (ADM) 

chroot chroot (S) 

chrtbl chrtblQs/i) 

chsize chsize(S) 

ckpacct acctsh(ADM) 

cleantmp cleantmp (ADM) 

clear clear(C) 

clearerr /error (S) 

clock clock (F) 

clock clock (S) 

close close (S) 

clone clone (M) 

closedir directory (S) 

clri drz (ADM) 

cmchk cmchk(C) 

cmos cmo5(HW) 

cmp cmp(C) 

col col(C) 



coltbl coltbl (M) 

comb comb (CP) 

comm comm(C) 

compress compress (C) 

configure configure (ADM) 

console console (M) 

consoleprini. consoleprint (ADM) 

conv conv(S) 

convkey mapkey(M) 

copy copy(C) 

core core(F) 

cos trig(S) 

cosh sinh(S) 

cp cp(C) 

cpio cpio(C) 

cpio cpio (F) 

cpp cpp (CP) 

cprintf cprintf (DOS) 

cputs cputs^DOS) 

crash crash(ADM) 

creat creat(S) 

creatsem creatsem(S) 

cref cref (CP) 

cron cron(C) 

"crontab** ”crontab"(C) 

crypt crypt (C) 

cscanf cscanf(JDOS) 

csh csh(C) 

csplit csplit(C) 

ctags ctags (CP) 

ctermid ctermid(S) 

ctime ctim^(S) 

ctype ctype (S) 

cu cu(C) 

curses curses(S) 

curtbl curtbl (M) 

cuserid cuserid(S) 

custom custom(ADM) 

cut cut(C) 

cvtcoff cvtcoJ/(M) 

cvtomf cvtomf(M) 

cxref cxref (CP) 

daemon.mn daemon.mn(M) 

date date(C) 

dbmbuild dbmbuild(ADM) 

dbminit dbm(S) 
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dc dc{C) 

dcopy dcopy{PiDM) 

dd dd{C) 

deassign assign(C) 

default default (F) 

defopen defopen(S) 

defread defopen(S) 

delete dbm(S) 

deliver deliver (ADM) 

delta delta (CP) 

del.vd del.vd(ADM) 

devices devices (F) 

devnm devnm(C) 

df df(C) 

dial dial(ADM) 

dial dial(S) 

dialcodes dialcodes(F) 

dialers dialers (¥) 

diff diff(C) 

difB dijf3(C) 

dir dir(F) 

dircmp dircmp(C) 

directory directory (S) 

dirent dirent(^ 

dirname dirname(C) 

disable disable (C) 

diskcmp diskcp(C) 

diskcp diskcp(C) 

diskusg diskusg (ADM) 

display display (UW) 

displaypkg .displaypkg (ADM) 

divvy t3f/vvy(ADM) 

dlayout dlay out (ADM) 

dlvr^audit ..dlvr audit (ADM) 

dmesg dmesg(ADM) 

dodisk acctsh (ADM) 

dos dos(C) 

doscat dos(C) 

doscp dos(C) 

dosdir dos(C) 

dosexterr dosexter (DOS) 

dosformat dos(C) 

dosld dosld (CP) 

dosls dos(C) 

dosmkdir dos(C) 

dosrm dos(C) 



dosrmdir 


dosiC) 


dparam 


.. dparam(ADM) 


drand48 


drand48(S) 


dtox 


dtox(C) 


dtype 


dtype (C) 


du 


du(C) 


dumpdir 




dup 


dup(S) 


dup2 


dup{S) 


echo 


echo(C) 


ecvt 




ed 


ed(C) 


edata 


end(S) 


edit 


ex(C) 


egrep 


greplC) 


enable 




end 


end(S) 


endgrent 


getgrentls) 


endpwent 


getpwent(S) 


endutent 


getutlS) 


env 


env(C) 


environ 


environ (M) 


eof 


eo/(DOS) 


erand48 


drand48(S) 


erf 


erfiS) 


erfc 


erfiS) 


errno 


perror(S) 


error 


errorQA) 


etext 


end(S) 


ev block 


ev block (S) 


ev close 


ev close (S) 


ev count 




ev flush 




ev getdev 


ev getdev (S) 


ev_getemask . 


ev gtemsk(S) 


ev gindev 


ev gindev(S) 


ev ink 


ev init (S) 


ev open 


ev open(S) 


ev_pop 


ev _pop(S) 


ev read 


ev read(S) 


ev resume 


ev resume (S) 


ev_setemask .. 


ev stemsk(S) 


ev_suspend .... 


ev susp(S) 


ex 


ex(C) 


execl 


exec(S) 


execle 


exec(S) 




exedp 


exec(S) 


execseg 


execseg (S) 


execv 


exec(S) 


execve 


exec(S) 


execvp 


exec(S) 


exit 


exit (DOS) 


exit 


exit(S) 


exp 


exp(S) 


expr 


expr(C) 


fabs 


...floorlS) 


factor 


factor(C) 


false 


falseiC) 


fclose 


fclose (DOS) 


fclose 


fclose (S) 


fcloseall 


fclose (DOS) 


fconvert 


fconvert (M) 


fcntl 


/cnf/(M) 


fcntl 


fcntl{S) 


fcvt 


ecvt(S) 


f d 


/d(HW) 


fdisk 


/dM(ADM) 


fdopen 


• fopen(S) 


fdswap 


fdswap (ADM) 


feof 


ferror(S) 


ferror 


ferroriS) 


fetch 


dbm(S) 


fflush 


fclose (S) 


fgetc 


fgetc (DOS) 


fgetc 


getc(S) 


fgetchar 


fgetc (DOS) 


fgets 


gets(S) 


fgrep 


grep(C) 


file 


file(C) 


hlehdr 


filehdr(F) 


filelength 


fileleng (DOS) 


fileno 


/error(S) 


filesys 


filesys (F) 


filesystem .... 


filesystem (F) 


find 


find(C) 


finger 


finger (O 


firstkey 


dbm(S) 


fixhdr 


fixhdr (C) 


fixperm 


....fixperm (ADM) 


floor 


floor (S) 


flushall 


flushall(DOS) 


fmod 


floor (S) 



fopen fopen(S) 

fork fork(S) 

format format (C) 

fp_off fp_seg (DOS) 

fp^seg ^ .s^^(DOS) 

fprintf printf(S) 

fputc fputc(DOS) 

fputc putc(S) 

fputchar fputc (DOS) 

fputs puts(S) 

fread fread(S) 

free malloc(S) 

freopen fopen(S) 

frexp frexpls) 

fsave /?av^(ADM) 

fscanf scanf(S) 

fsck fsck(ADM) 

fsdb fsdb(ADM) 

fseek fseek(S) 

fsname fsname (ADM) 

fspec fspec(^ 

fsphoto fsphoto (ADM) 

fsstat fsstat(ADM) 

fstat stat(S) 

fstatfs statfs(S) 

fstyp fstyp (ADM) 

ftell fseek (S) 

ftime time(S) 

ftok stdipc(S) 

ftw ft^(^) 

fuser fuser(C) 

fwrite fread(S) 

fwtmp fwtmp(ADM) 

fxlist xlist(S) 

gamma gamma(S) 

gcvt ecvt(S) 

get get(C?) 

getc getc(S) 

getch getch(DOS) 

getchar getc(S) 

getche getche (DOS) 

getclk getclk(M) 

getcwd getcwd(S) 

getdents getdents(S) 

getegid getuid(S) 

getenv getenv(S) 



IV 




geteuid 


getuid (S) 


getgid 


getuid (S) 


getgrent 


getgrent (S) 


getgrgid 


getgrent (S) 


getgrnam 


getgrent iS,) 


gethostid 




getkernelid ... 


.... getsystemid (S) 


getlogin 


getloginlS) 


getopt 


getopt (C) 


getopt 


getopt (S) 


getoptcvt 




getopts 


getopts (C) 


getpass 


getpass (S) 


getpgrp 


getpid (S) 


getpid 


getpid {S) 


getppid 


getpid {S) 


getpw 


getpw {S) 


getpwent 


getpwent (S) 


getpwnam .... 


getpwent (S) 


getpwuid 


getpwent (S) 


gets 


gets{C) 


gets 


^e«(S) 


getsystemid .. 


.... getsystemid (S) 


getty 


getty {M) 


"gettydefs" ... 


"gettydefs" (Fi 


getuid 


getuid (S) 


getut 


getut (S) 


getutent 


getut (S) 


getutid 


getut (S) 


getutline 


getut (S) 


getw 


getc(S) 


gmtime 


ctime (S) 


goodpw 


... ;^<9<9(i/7w(ADM) 


gps 


gps(p) 


graph 


graph(ADM) 


greek 


greek (C) 


grep 


grepiC) 


group 


grouped 


grpcheck 


grpcheck (C) 


gsignal 


ssignal(S) 


haltsys 


haltsys {kT>M) 


hashcheck .... 


spelliC) 


hashmake 


spell(C) 


hcreate 


hsearch (S) 


hd 


W(C) 


hd 


W(HW) 



hdestroy hsearch(S) 

hdr hdr(CP) 

hdutil hdutil (ADM) 

head head(C) 

hello hello (C) 

help help (CP) 

hostid hostid(C) 

hp hp(C) 

hs hs(P) 

hsearch hsearch(S) 

hwconfig hwconfig(C) 

hypot hypot(S) 

i286emul i286emul(C) 

1386 machid(C) 

id iV/(ADM) 

id id(C) 

idaddld idaddld(ADM) 

idbuild idbuild(ADM) 

idcheck idcheck (ADM) 

idinstall idinstall (ADM) 

idleout idleout(ADM) 

idload idload(ADM) 

idmemtune Admemtune (ADM) 

idmkinit idmkinit (ADM) 

idspace idspace(ADM) 

idtune idtune(ADM) 

imacct imacct(C) 

infocmp inf ocmp (ADM) 

inir init(M) 

init /n/Y(M) 

initcond initcond (ADM[) 

inittab inittab(F) 

inode inode (I^ 

inp mp(DOS) 

install install (ADM) 

installpkg ,.,Anstallpkg (ADM) 

int86 int86 (DOS) 

int86x int86x(DOS) 

intdos intdos (DOS) 

intdosx intdosx(DOS) 

integrity integrity (ADM) 

ioctl ioctl(S) 

ipcrm ipcrm(NDM) 

ipcs ipcs (ADM) 

ips ips (ADM) 

isalnum ctype (S) 




isalpha ctype(S) 

isascii ctype (S) 

isatty isatty(DOS) 

isatty ttyname(S) 

isbs ips (ADM) 

iscntrl ctype(S) 

isdigit ctype (S) 

isgraph ctype(S) 

islower ctype(S) 

ismpx ismpx(C) 

isprint ctype (S) 

ispunct ctype (S) 

isspace ctype (S) 

issue issue (F) 

isupper ctype (S) 

isverify isverify (M) 

isxdigit ctype (S) 

itoa itoa (DOS) 

jO bessel(S) 

jl bessel(S) 

jagent jagent(M) 

jn bessel(S) 

join join(C) 

Jrand48 drand48(S) 

jterm jterm(C) 

jwin jwin(C) 

kbhit kbhit(DOS) 

kbmode kbmode (ADM) 

keyboard keyboard (}TW) 

kill kill(C) 

kill kill(S) 

killall killall (ADM) 

kmem mem(¥) 

ksh ksh(C) 

1 /(C) 

13tol l3tol(S) 

164a a64l(S) 

labelit labelit (ADM) 

labs labs (DOS) 

langinfo langinfo(F) 

last last(C) 

lastlogin acctsh (ADM) 

layers layers (C) 

layers layers (M) 

Ic lc(C) 

lcong48 drand48(S) 



Id ld(CF) 

Id ld(M) 

Idexp frexp(S) 

Idfcn ldfcn(F) 

Idfcn Idfcn (¥) 

lex lex(CF) 

Ifind lsearch(S) 

limits limits (¥) 

line line(C) 

linenum linenum(¥) 

link link(ADM) 

link link(S) 

link_unix link_unix(ADM) 

lint lint (CF) 

list list (ADM) 

In ln(C) 

locale locale (M) 

localtime ctime (S) 

lock lock(C) 

lock lock(S) 

lockf lockfls) 

locking locking (S) 

log exp(S) 

log log(M) 

loglO exp(S) 

login login (M) 

logname logname(C) 

logname logname (S) 

logs logs(¥) 

longjmp setJmp(S) 

lorder lorder (CF) 

Ip lp(Q 

Ip //7(HW) 

IpO //?(HW) 

Ipadmin Ipadmin(ADM) 

Ipfilter lpfilter(ADM) 

Ipforms Ipforms (ADM) 

Ipmove Ipsched (ADM) 

Iprint lprint(C) 

Ipsched Ipsched (ADM) 

Ipsh lpsh(ADM) 

Ipshut Ipsched(ADM) 

Ipstat lpstat(C) 

Ipusers Ipusers (ADM) 

lrand48 drand48(S) 

Is ls(C) 



VI 




Isearch lsearch(S) 

Iseek lseek(S) 

Itoa Itoa (DOS) 

ltol3 l3tol(S) 

m4 m4(CP) 

machid machid(C) 

machine machine (ITW) 

mail mail(C) 

maildelivery .. mailde livery (F) 
majorsinuse. majorsinuse (ADM) 

make make (CP) 

makekey makekey (ADM) 

malloc malloc(S) 

man man(C) 

mapchan mapchan(F) 

mapchan mapchan(M) 

mapkey mapkey(M) 

mapscrn mapkey (M) 

mapstr mapkey (M) 

masm masm(CP) 

math math(M) 

matherr matherr(S) 

maxuuscheds , maxuuscheds(P) 

maxuuxqts maxuuxqts^F) 

mconvert mconvertQs/i) 

mdevice mdevice(F) 

meisa meisa(F) 

mem mem(F) 

memccpy memory (S) 

memchr memory (S) 

memcmp memory (S) 

memcpy memory (S) 

memset memory (S) 

memtune memtune(F) 

mesg mesg(C) 

messages messages 

mestbl mestbKM) 

mfsys mfsys (F) 

micnet micnetf^) 

mkdev mkdev(ADM) 

mkdir mkdir(C) 

mkdir mkdir(DOS) 

mkfs mkfs (ADM) 

mknod mknod(C) 

mknod mknod (S) 

mkstr mkstr(CP) 



mktemp mktemp(S) 

mmdf mmdf(ADM) 

mmdfalias ,, mmdf alias (ADM) 

mnlist mnlist (ADM) 

mnttab mnttab(F) 

modf frexp(S) 

monacct acctsh(ADM) 

monitor monitor(S) 

montbl montbl(M) 

more more(C) 

mount mount (ADM) 

mount mount(S) 

mountall mountall(ADM) 

mouse mouse 

movedata movedataiJDOS) 

mrand48 drand48(S) 

mscreen mscreen(M) 

msgctl msgctl(S) 

msgget msgget(S) 

msgop msgop(S) 

mtune mtune(T) 

multiscreen multiscreen (M) 

mv mv(C) 

mvdir mvdir (ADM) 

nap nap(S) 

nbwaitsem waitsem(S) 

ncheck ncheck (ADM) 

netutil netutil (ADM) 

newform newform(C) 

newgrp newgrp(C) 

news news(C) 

nextkey dbm(S) 

nice nice(C) 

nice nice(S) 

nictable nictable (ADM) 

nl nl(C) 

nlist nlist(S) 

nlsadmin nlsadmin(ADM) 

nMype nl type (F) 

nm nm(CP) 

nohup nohup(C) 

nrand48 drand48(S) 

null null(F) 

nulladm acctsh (ADM) 

numtbl numtbl(M) 

od od(C) 



Vll 




open 


open(S) 


opendir 


directory (S) 


opensem 


opensem(S) 


Otar 




outp 


outp (DOS) 


pack 


pack(C) 


parallel 


parallel (WN) 


passwd 


passwd(C) 


passwd 


passwd(F) 


paste 


paste (C) 


pause 


pause (S) 


pax 


pax{C) 


peat 


pack(C) 


pclose 


popen(S) 


pepio 


pepio (C) 


pen 


/7Cm(ADM) 


permissions .. 


... permissions (F) 


perror 


perror (S) 


Pg 


pgiC) 


pipe 


pipe{S) 


plock 


plock (S) 


plot 


plot(F) 


pnch 


pnch(F) 


poll 


po//(F) 


popen 


popen(S) 


pow 


exp(S) 


powerfail 


powerfail (M) 


pr 


pr(C) 


pretmp 


acctsh(ADM) 


prdaily 


acctshlADM) 


prf 


prf(jm 


prfdc 


... profiler (ADM) 


prfld 


... profiler(ADM) 


prfpr 


... profiler (ADM) 


prfsnap 


...profiler (ADM) 


prfstat 


... profiler (ADM) 


printf 


printf (S) 


proctl 


proctl (S) 


prof 


prof (CP) 


profil 


profiKS) 


profile 


profile (M) 


profiler 


... profiler (ADM) 


promain 




proto 


proto (ADM) 


prs 


prs(CP) 


prtacct 

viii 


occtt/i(ADM) 



PS 

pscat 

pstat 

ptrace 

purge 

purge 

putc 

putch 

putchar ... 

putenv 

putpwent 

puts 

pututline 

putw 

pwcheck .. 

pwd 

qsort 

queue 

queuedefs 

quot 

ramdisk .. 

rand 

random ... 

ranlib 

ratfor 

rcO 

rc2 

rep 

revtrip .... 

rdchk 

read ........ 

readdir ... 
realloc .... 

reboot ...., 

red 

reduce .... 
regemp ... 
regemp ... 

regex 

regexp ..... 

reject 

reloc 

relogin .... 
remote ... 



ps(C) 

pscat (C) 

pstat (C) 

ptrace (S) 

purge (C) 

purge (Jr) 

putc(S) 

...patch (DOS) 

putc(S) 

putenv (S) 

... putpwent (S) 

puts(S) 

getutlS) 

putc(S) 

... pwcheck (C) 

pwd(C) 

qsort (S) 

queue (¥) 

.. queuedefs 

quot(C) 

. ramdisk(l^) 

rand(S) 

random(C) 

ranlib(CP) 

ratfor(CP) 

rcO (ADM) 

rc2 (ADM) 

rcp(C) 

revtrip (C) 

rdchk(S) 

read(S) 

... directory (S) 

malloc(S) 

haltsys (ADM) 

ed(C) 

reduce (kDM) 
.... regemp (CP) 

regex(S) 

regex(S) 

regexp (S) 

, accept (ADM) 

reloc (F) 

relogin (ADM) 
remote (C) 



removepkg . removepkg(PiDM) 



rename rename(J^OS) 




restart restart (M) 

restore restore (ADM) 

rewind fseek(S) 

rewinddir directory (S) 

rm rm(C) 

rmail rmail (ADM) 

rmb rmb(M) 

rmdel rmdel(CP) 

rmdir rm(C) 

rmdir rmdir(DOS) 

routines routines (ADM) 

rsh rsh(C) 

rtc rtc(HW) 

runacct acct^/i(ADM) 

runacct runacct (ADM) 

sal 5^ar(ADM) 

sa2 .sar(ADM) 

sact sact(CP) 

sadc sar(ADM) 

sag 5 ^flg(ADM) 

sar 5 ar(ADM) 

sbrk sbrk(S) 

scanf scanflS) 

sccsdiff sccsdiff(CP) 

sccsfile sccsfile(F) 

schedule schedule (ADM) 

scnhdr scnhdr(F) 

scr_dump scr_dump(F) 

screen screen (HW) 

SCSI scsi(HW) 

scsinfo scsinfo (ADM) 

sdb sdb(CP) 

sddate sddate(C) 

sdenter sdenter(S) 

sdevice sdevice (F) 

sdfree sdget(S) 

sdget sdget(S) 

sdgetv sdgetv(S) 

sdiff sdiff(C) 

sdleave sdenter (S) 

sdwaitv sdgetv (S) 

sed sed(C) 

seed48 drand48(S) 

seekdir directory (S) 

segread segread(DOS) 

select select (S) 



semctl semctl (S) 

semget semget(S) 

semop semop(S) 

send send(ADM) 

serial serial (FP^) 

setbuf setbuf(S) 

setclock setclock (ADM) 

setcolor setcolor(C) 

setgid setuid(S) 

setgrent getgrent(S) 

setjmp setjmp(S) 

setkey setkey(C) 

setlocale setlocale (S) 

setmnt setmnt (ADM) 

setmode setmode (C) 

setmode setmode (DOS) 

setpgrp setpgrp(S) 

setpwent getpwent(S) 

settime settime (ADM) 

setuid setuid(S) 

setutent getut(S) 

setvbuf setbuf (S) 

sfsys sfsys (F) 

sgetl sputl(S) 

sh sh(Cf) 

shl shl(C) 

shmctl shmctl(S) 

shmget shmget(S) 

shmop shmop(S) 

shutacct acctsh (ADM) 

shutdn shutdn(S) 

shutdown shutdown(ADM) 

signal signal (S) 

sigsem sigsem(S) 

sin trig(S) 

sinh sinh(S) 

size size (CP) 

sleep sleep (C) 

sleep sleep (S) 

sopen sopen(DOS) 

sort sort(C) 

spawnl spawn(DOS) 

spawnvp 5/?aw/i(DOS) 

spell spell (C) 

spellin spell (C) 

spline spline (C) 




split split (C) 

sprintf printf lS) 

sputl sputl(S) 

sqrt exp(S) 

srand48 rand(S) 

sscanf scanflS) 

ssignal ssignallS) 

startup acctsh(ADM) 

stat stat(F) 

stat stat(S) 

statfs staffs iS) 

stdio stdio(S) 

stime stime(S) 

store dbm(S) 

strace strace(ADM) 

strcat string (S) 

strchr string (S) 

strclean strclean(ADM) 

strcmp string (S) 

strcpy string (S) 

strcspn string (S) 

strdup string (S) 

strerr strerr(ADM) 

streamio streamio(M) 

strftime strftime(S) 

string stringlS) 

strings strings (C) 

strip strip (CP) 

strlen strlen(DOS) 

strlwr strlwr (DOS) 

strmcfg strmcfg (ADM) 

strmtune strmtune (ADM) 

strncat string (S) 

strncmp string (S) 

strncpy string (S) 

strpbrk string (S) 

strrchr string (S) 

strrev strrev (DOS) 

strset strset (DOS) 

strspn string (S) 

strtod strtod(S) 

strtok stringlS) 

strtol strtol(S) 

strupr strupr(DOS) 

stty stty(C) 

stune stune (F) 



su 


su(C) 


submit 


submit (ADM) 


subsystem ... 


subsystem(M) 


sulogin 


sulogin(ADM) 


sum 


sum(C) 


swab 




swap 




swconfig 


swconfig (C) 


sxt 


sxt(M) 


syms 


.yyAw.s(F) 


sync 




sync 


sync(S) 


sys errlist ... 


perror(S) 


sys nerr 


perror(S) 


sysadmsh ..... 


.. sysadmsh(PiDM) 


sysdef 


sysdef(ADW^ 


sysfiles 


sysfiles (P) 


sysi86 


sysi86(S) 


system 




systemid 


systemid (^) 


systems 




systty 




tables 


tables (^) 


tabs 


tabs(C) 


tail 


Mi/(C) 


tarn 




tan 


triglS) 


tanh 


sinh(S) 


tape 


tape(C) 


tape 


tape(l^) 


tapecntl 


tapecntl (C) 


tapedump ... 


tapedump (C) 


tar 


tar(0 


tar 





tcbck 


tcbck{ADM) 


tdelete 


tsearch(S) 


tee 


tee{C) 


tell 


telHpOS) 


telldir 


directory (S) 


tempnam .... 




term 


fcwi(F) 


termcap 


termcap fP) 


terminal 


terminal (y^) 


terminals .... 




"terminfo" . 


’'terminfo'" (P) 


"terminfo" 


"terminfo"(M) 




"terminfo” .... 


"tenninfo'XS) 


TZ 


tz(M) 


termio 




tzset 


ctime (S) 


termios 


termios (M) 


uadmin 


uadmin(S) 


test 


test(C) 


uconfig 


.... uconfig(ADM) 


tfind 




ulimit 




tgetent 


termcap(S) 


ultoa 




tgetflag 


termcapiS) 


umask 


umask(C) 


tgetnum 




umask 


umask(S) 


tgetstr 


termcap (S) 


amount 


umount (ADM) 


tgoto 


termcap (S) 


amount 


umount (S) 


tic 


ric(C) 


umountall ... 


.. mountall(ADyP) 


time 




uname 




time 


time(S) 


uname 


uname (S) 


times 




uncompress 


compress(C) 


timex 


timex (ADM) 


unget 


unget (CP) 


timezone 


timezone (F) 


ungetc 


ungetc (S) 


timod 




ungetch 


ungetchCDO^) 


tirdwr 




uniq 


uniq(C) 


tmpdle 


tmpfile(Sj 


unistd 




tmpnam 




units 


units (C) 


toascii 




unlink 


/M(ADM) 


toascii 


ctype(S) 


unlink 


unlink (S) 


tolower 


c^?nv(S) 


unpack 


pack(C) 


tolower 


ctype(S) 


upcfg 


upscfgiS) 


top 


top(F) 


upsconfig .... 


. upsconfig (ADM) 


top.next 


top(F) 


uptime 


uptime (C) 


touch 




usemouse .... 




toupper 


co«v(S) 


ustat 


ustat (S) 


toupper 


ctype(S) 


utime 


utime (S) 


tplot 


tplot(ADM) 


utmp 


utmp(F) 


tput 


tput(Q) 


utmpname .. 


getut(S) 


tputs 


termcap (S) 


uuchat 


dial(ADM) 


tr 


tr{C) 


uucheck 


.... uucheck(ADM) 


translate 


translate (C) 


uucico 


uucico (ADM) 


trchan 


trchan (M) 


uuclean 


.... uuclean(ADM) 


true 


true(C) 


UUCP 


uucp(C) 


tsearch 


tsearch (S) 


uuencode 




tset 


tset(C) 


uugetty 


uugetty (ADM) 


tsort 


tsort (CP) 


uuinstall 


... uuinstall (ADM) 


tty 


tty(C) 


uulist 


MW to (ADM) 


tty 


/O’(M) 


uulog 


uucp(C) 


tty name 


ttyname (S) 


uuname 


uucp(C) 


tty slot 




uupick 




turnacct 


acctsh(ADM) 


uusched 


.... uusched (ADM) 


twalk 


tsearch(S) 


uustat 


uustat (C) 


types 


types 


uuto 


uuto(C) 




uutry uutry (ADM) 

uux uux(C) 

uuxqt uuxqt(ADM) 

val val(CP) 

values values(M) 

varargs varargs(S) 

VC vc(C) 

vddaemon ... vddaemon(ADM) 

vdinfo vdinfo(ADM) 

vdutil vdutil (ADM) 

vectorsinuse. vectorsinuse (ADM) 

vedit VI (C) 

vfprintf vprintf(S) 

vi v/(C) 

vidi vidi(C) 

view vi(C) 

vmstat vmstat(C) 

volcopy volcopy(ADM) 

vprintf vprintf(S) 

vsprintf vprintf (S) 

w w(C) 

wait wait(C) 

wait wait(S) 

waitsem waitsem(S) 

wall wall(ADM) 

wc wc(C) 

what what(C) 

who who(C) 

whodo whodo(C) 

write write (C) 

write write (S) 

wtinit wtinit (ADM) 

vitmp utmp(F) 

wtmpfix Jwtmp (ADM) 

x286emul ..,x286emul(C) 

xargs xargs(C) 

xbackup xbackup (ADM) 

xbackup xbackup (F) 

xinstall xinstall (ADM) 

xlist xlist(S) 

xprcat xprcat(C) 

xprsetup xprsetup (ADM) 

xprtab xprtab(F) 

xref xref (CF) 

xrestore xrestore (ADM) 

xstr xstr(CP) 



xii 



xt xr(HW) 

xtod xtod(C) 

xtproto xtproto(M) 

xts jc/^(ADM) 

xtt xrf(ADM) 

yO bessel(S) 

yl bessel(S) 

yacc yacc (CP) 

yes y€s(C) 

yn bessel(S) 

zcat compress(C) 
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Commands (C) 



Intro 
300, 300s 

4014 

450 

assign, deassign 

at, batch 

auths 

awk 

banner 

basename 

be 

bdilf 

bfs 

cal 

calendar 

cat 

cd 

checkmail 

chgrp 

chmod 

chown 

clear 

cmchk 

emp 

col 

comm 
compress, 
uncompress, zcat 

copy 

cp 

cpio 

cron 

crontab 



introduces Altos UNIX System V commands 

handle special functions of DASI 300 and 300s 

terminals 

paginator for the TEKTRONIX 4014 terminal 
handle special functions of the DASI 450 terminal 
assigns and deassigns devices 
executes commands at a later time 
list and/or restrict kernel authorizations 
pattern scanning and processing language 
prints large letters 

removes directory names from pathnames 

invokes a calculator 

compares files too large for diff(C) 

scans big files 

prints a calendar 

invokes a reminder service 

concatenates and displays files 

changes working directory 

checks for mail which has been submitted but not 

delivered 

changes group ID 

changes the access permissions of a file or directory 

changes owner ID 

clears a terminal screen 

reports hard disk block size 

compares two files 

filters reverse linefeeds 

selects or rejects lines common to two sorted files 

compress data for storage, uncompress and display 
compressed files 
copies groups of files 
copies files 

copy file archives in and out 

executes commands scheduled by at, batch, and 
crontab 

schedule commands to be executed at regular 
intervals 
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crypt 

csh 

csplit 

cu 

cut 

date 

dc 

dd 

devnm 

df 

diff 

difB 

dircmp 

dirname 

disable 

diskcp, diskcmp 
dos: doscat, 
doscp, dosdir, 
dosformat, 
dosmkdir, dosls, 
dosrm, dosrmdir 

dtox 

dtype 

du 

echo 

ed, red 

enable 

env 

ex, edit 

expr 

factor 

false 

file 

find 

finger 

fixhdr 

format 

fuser 

getopt 

getopts, getoptcvt 

gets 

greek 



encode/decode 

invokes a shell command interpreter with C-like 
syntax 

splits files according to context 

call another UNIX/XENIX system 

cuts out selected fields of each line of a file 

prints and sets the date 

invokes an arbitrary precision calculator 

converts and copies a file 

identifies device name 

report number of free disk blocks 

compares two text files 

compares three files 

compares directories 

delivers directory part of pathname 

turns off terminals and printers 

copies or compares floppy disks 



access to and manipulation of DOS files and DOS 
filesystems 

change file format from MS-DOS to UNIX 

determines disk type 

summarizes disk usage 

echo arguments 

invokes the text editor 

turns on terminals and line printers 

sets environment for command execution 

invokes a text editor 

evaluates arguments as an expression 

factor a number 

returns with a nonzero exit value 
determines file type 
finds files 

finds information about users 
changes executable binary file headers 
format floppy disks and mini-cartridge tapes 
Identify processes using a file or file structure 
parses command options 
parses command options 
gets a string from the standard input 
select terminal filter 
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grep, egrep, fgrep 

grpcheck 

hd 

head 

hello 

hostid 

hp 

hwconfig 

i286emul 

id 

ismpx 

join 

Jterm 

jwin 

kill 

ksh, rksh 
1 

last 

layers 

Ic 

line 

In 

lock 

logname 
Ip, cancel 
Iprint 
Ipstat 
Is 

machid: 1386 

mail 

man 

mesg 

mkdir 

mknod 

mnt, umnt 

more 

mv 

newform 

newgrp 

news 

nice 

nl 



searches a file for a pattern 
checks group file 

displays files in hexadecimal format 
prints the first few lines of a file 
send a message to another user 
Print unique hardware ID 

handle special functions of Hewlett-Packard 
terminals 

read the configuration information 

emulate UNDC 80286 

prints user and group IDs and names 

return windowing terminal state 

joins two relations 

reset layer of windowing terminal 

print size of layer 

terminates a process 

KomShell, a standard/restricted command and 

programming language 

lists information about contents of directory 

indicate last logins of users and teletypes 

layer multiplexer for windowing terminals 

lists directory contents in columns 

reads one line 

makes a link to a file 

locks a user’s terminal 

gets login name 

send/cancel requests to lineprinter 

print to a printer attached to the user’s terminal 

print information about status of LP print service 

gives information about contents of directories 

get processor type truth value 

interactive message processing system 

prints reference pages in this guide 

permits or denies messages sent to a terminal 

makes a directory 

builds special files 

mount a filesystem 

views a file one screen full at a time 

moves or renames files and directories 

changes the format of a text file 

logs user into a new group 

print news items 

runs a command at a different scheduling priority 
adds line numbers to a file 




nohup 


runs a command immune to hangups and quits 


od 


displays files in octal format 


Otar 


original tape archive command 


pack, peat, 




unpack 


compresses and expands files 


passwd 


change login, modem (dialup shell), filesystem, or 




group password 


paste 


merges lines of files 


pax 


portable archive exchange 


pepio 


copy file archives in and out 


Pg 


file perusal filter for soft-copy terminals 


pi- 


prints files on the standard output 


ps 


reports process status 


pscat 


ASCII-to-PostScript filter 


pstat 


reports system information 


ptar 


process tape archives 


purge 


overwrites specified files 


pwcheck 


checks password file 


pwd 


prints working directory name 


quot 


summarizes file system ownership 


random 


generates a random number 


rep 


copies files across systems 


revtrip 


notifies mail sender that recipient is away 


remote 


executes commands on a remote system 


rm 


removes files or directories 


rmdir 


removes directories 


rsh 


invokes a restricted shell (command interpreter) 


sddate 


prints and sets backup dates 


sdiif 


compares files side-by-side 


sed 


invokes the stream editor 


setcolor. 




setcolour 


set screen color and other screen attributes 


setkey 


assigns the function keys 


setmode 


Port modes utility 


sh 


invokes the shell command interpreter 


shl 


shell layer manager 


sleep 


suspends execution for an interval 


sort 


sorts and merges files 


spell, hashmake. 




spellin, 




hashcheck 


finds spelling errors 


spline 


interpolates smooth curve 


split 


splits a file into pieces 


strings 


find the printable strings in an object file 
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stty 


sets the options for a terminal 


su 


makes the user a super-user or another user 


sum 


calculates checksum and counts blocks in a file 


swconfig 


produces a list of the software modifications to the 
system 


tabs 


set tabs on a terminal 


tail 


displays the last part of a file 


tape, mcart 


magnetic tape maintenance program 


tapecntl 


AT&T tape control for QIC-24/QIC-02 tape device 


tapedump 


dumps magnetic tape to output file 


tar 


archives files 


tee 


creates a tee in a pipe 


test 


tests conditions 


tic 


terminfo compiler 


time 


times a command 


touch 


updates access and modification times of a file 


tput 


queries the terminfo database 


tr 


translates characters 


translate 


translates files from one format to another 


true 


returns with a zero exit value 


tset 


provide information to set terminal modes 


tty 


gets the terminal’s name 


umask 


sets file-creation mode mask 


uname 


prints the name of the current system 


uniq 


reports repeated lines in a file 


units 


converts units 


uptime 


displays information about system activity 


usemouse 


maps mouse input to keystrokes for use with non- 
mouse based programs 


UUCP, uulog. 




uuname 


UNIX-to-UNIX system copy 


uuencode, 

uudecode 


encode/decode a binary file for transmission via mail 


uustat 


uucp status inquiry and job control 


uuto, uupick 


public UNIX-to-UNIX system file copy 


uux 


UNIX-tO"UNIX system command execution 


VC 


version control 


vi, view, vedit 


invokes a screen-oriented display editor 


vidi 


sets the font and video mode for a video device 


vmstat 


report paging and system statistics 


w 


displays information about who is on the system and 
what they are doing 


wait 


awaits completion of background processes 


wc 


counts lines, words and characters 
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what 


identifies files 


who 


lists who is on the system 


whodo 


determines who is doing what 


write 


writes to another user 


x286einul 


emulate XENIX 80286 


xargs 


constructs and executes commands 


xprcat 


use transparent printer over modem line 


xtod 


change file format from UNIX to MS-DOS 


yes 


prints string repeatedly 



VI 
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INTRO (C) 



Intro 

introduces Altos UNIX System V commands 

Description 



This section describes how to use many of the general-purpose com- 
mands available in the Altos UNIX System V Operating System. 
These command are labeled with a C, as with date(C). The letter 
“C” stands for “command.” 

Other commands have different labels, such as CP (for “Command 
Programming”) or M (for “Miscellanous”). Refer to the “Preface” 
of this manual for a list of all the different reference sections, what 
commands and utilities each section describes, and in which manual 
each section is located. 

Note that some reference sections, most notable the CP and S sections, 
are included only with the Development System, which is an optional 
supplemental package not always included with the standard Operat- 
ing System. 

Syntax 



Unless otherwise noted, commands described in the Syntax section of 
a manual page accept options and other arguments according to the 
following syntax and should be interpreted as explained below. 

name [-option,..] [cmdarg...] 

where: 

[ ] Square brackets surround an option or cmdarg that is 

not required. 

I A pipe (vertical bar) separates mutually exclusive 

options. Choose one of the items separated by this 
symbol. 

Ellipses (three periods) indicate multiple occurrences 
of the option or cmdarg . 

name This specifies the name of an executable file. 

option (Always preceded by a “-”.) 

noargletter ... or, 
argletter optargl^...] 
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noargletter A single letter representing an option without an 
option-argument. Note that more than one noargletter 
option can be grouped after one (Rule 5 in the 
following text). 

argletter A single letter representing an option requiring an 
option-argument. 

optarg An option-argument (character string) satisfying a 

preceding argletter. Note that groups of optargs fol- 
lowing an argletter must be separated by commas or 
separated by white space and quoted (Rule 8 below). 

cmdarg Path name (or other command argument) not begin- 

ning with or by itself indicating the standard 
input. 



Command Syntax Standard: Rules 

These command syntax rules are not followed by all current com- 
mands, but all new commands use them, getopts (C) should be used 
by all shell procedures to parse positional parameters and to check for 
legal options. It supports Rules 3-10 below. The enforcement of the 
other rules must be done by the command itself. 

1. Command names {name above) must be between two and 
nine characters long. 

2. Command names must include only lowercase letters and 
digits. 

3. Option names {option above) must be one character long. 

4. All options must be preceded by 

5. Options with no arguments may be grouped after a single 



6. The first option-argument {optarg above) following an 
option must be preceded by white space. 

7. Option-arguments cannot be optional. 

8. Groups of option-arguments following an option must either 
be separated by commas or separated by white space and 
quoted (e.g., -o xxx,z,yy or -o ’*xxx z yy**). 

9. All options must precede operands {cmdarg above) on the 
command line. 
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10. may be used to indicate the end of the options. 

1 1 . The order of the options relative to one another should not 
matter. 

12. The relative order of the operands (cmdarg above) may 
affect their significance in ways determined by the command 
with which they appear. 

13. preceded and followed by white space should only be 
used to mean standard input. 

See Also 



getopts(C), exit(S), wait(S), getopt(S) 

Diagnostics 



Upon termination, each command returns 2 bytes of status, one sup- 
plied by the system and giving the cause for termination, and (in the 
case of “normal” termination) one supplied by the program (see 
wait(S) and exit(S)). The former byte is 0 for normal termination; the 
latter is customarily 0 for successful execution and nonzero to indicate 
troubles such as erroneous parameters, bad or inaccessible data. It is 
called variously “exit code”, “exit status”, or “return code”, and is 
described only where special conventions are involved. 

Notes 



Not all commands adhere to the syntax described here. 
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300, 300s 

handle special functions of DASI 300 and 300s termi- 
nals 

Syntax 

300 [ +12 ] [ -« ] [ -dt,l,c ] 

300s [ +12 ] [ -n ] [ -dt,l,c ] 

Description 



The 300 command supports special functions and optimizes the use of 
the DASI 300 (GSI 300 or DTC 300) terminal; 300s performs the same 
functions for the DASI 300s (GSI 300s or DTC 300s) terminal. It con- 
verts half-line forward, half-line reverse, and full-line reverse motions 
to the correct vertical motions. In the following discussion of the 300 
command, it should be noted that unless your system contains the text 
processing software, references to certain commands (e.g., nrojf, 
neqn, eqn, etc.) will not work. It also attempts to draw Greek letters 
and other special symbols. It permits convenient use of 12-pitch text. 
It also reduces printing time 5 to 70%. The 300 command can be used 
to print equations neatly, in the sequence: 

neqn file . . . | nroff | 300 

WARNING: if your terminal has a PLOT switch, make sure it is turned 
on before 300 is used. 

The behavior of 300 can be modified by the optional flag arguments to 
handle 12-pitch text, fractional line spacings, messages, and delays. 

+12 permits use of 12-pitch, 6 lines/inch text. DASI 300 termi- 
nals normally allow only two combinations: 10-pitch, 6 
lines/inch, or 12-pitch, 8 lines/inch. To obtain the 12-pitch, 
6 lines per inch combination, the user should turn the 
PITCH switch to 12, and use the +12 option. 
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-n controls the size of half-line spacing. A half-line is, by 

default, equal to 4 vertical plot increments. Because each 
increment equals 1/48 of an inch, a 10-pitch line- feed 
requires 8 increments, while a 12-pitch line-feed needs 
only 6. The first digit of n overrides the default value, thus 
allowing for individual taste in the appearance of sub- 
scripts and superscripts. For example, nrojf half-lines could 
be made to act as quarter-lines by using -2. The user could 
also obtain appropriate half-lines for 12-pitch, 8 lines/inch 
mode by using the option -3 alone, having set the PITCH 
switch to 12-pitch. 

controls delay factors. The default setting is -d3,90,30. 
DASI 300 terminals sometimes produce peculiar output 
when faced with very long lines, too many tab characters, 
or long strings of blankless, non-identical characters. One 
null (delay) character is inserted in a line for every set of t 
tabs, and for every contiguous string of c non-blank, non- 
tab characters. If a line is longer than / bytes, l-i-(total 
length)/20 nulls are inserted at the end of that line. Items 
can be omitted from the end of the list, implying use of the 
default values. Also, a value of zero for t (c) results in two 
null bytes per tab (character). The former may be needed 
for C programs, the latter for files like /etc/passwd. 
Because terminal behavior varies according to the specific 
characters printed and the load on a system, the user may 
have to experiment with these values to get correct output. 
The -d option exists only as a last resort for those few cases 
that do not otherwise print properly. For example, the file 
/etc/passwd may be printed using -d3,30,5. The value 
-d0,l is a good one to use for C programs that have many 
levels of indentation. 

Note that the delay control interacts heavily with the pre- 
vailing carriage return and line-feed delays. The stty{C) 
modes nlO cr2 or nlO cr3 are recommended for most uses. 

The 300 command can be used with the nroff -s flag or .rd requests, 
when it is necessary to insert paper manually or change fonts in the 
middle of a document. Instead of hitting the return key in these cases, 
you must use the line-feed key to get any response. 

In many (but not all) cases, the following sequences are equivalent: 

nroff -T300 files . . . and nroff files . . . | 300 
nroff -T300-12 files . . . and nroff files . . . | 300 +12 

The use of 300 can thus often be avoided unless special delays or 
options are required; in a few cases, however, the additional move- 
ment optimization of 300 may produce better aligned output. 
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See Also 

450(C), mesg(C), graph(ADM), stty(C), tabs(C), tplbt(ADM) 

Notes 



Some special characters cannot be correctly printed in column 1 
because the print head cannot be moved to the left from there. 

If your output contains Greek and/or reverse line-feeds, use a friction- 
feed platen instead of a forms tractor; although good enough for drafts, 
the latter has a tendency to slip when reversing direction, distorting 
Greek characters and misaligning the first line of text after one or 
more reverse line-feeds. 
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4014 

paginator for the TEKTRONIX 4014 terminal 

Syntax 

4014 [ -t J [ -n ] t -cN ] [ -pL ] [ file ] 

Description 



The output of 4014 is intended for a TEKTRONIX 4014 terminal; 
4014 arranges for 66 lines to fit on the screen, divides the screen into 
N columns, and contributes an eight-space page offset in the (default) 
single-column case. Tabs, spaces, and backspaces are collected and 
plotted when necessary. TELETYPE Model 37 half- and reverse-line 
sequences are interpreted and plotted. At the end of each page, 4014 
waits for a new-line (empty line) from the keyboard before continuing 
on to the next page. In this wait state, the command land will send 
the cmd to the shell. 

The command line options are: 

-t Do not wait between pages (useful for directing output into a file). 

-n Start printing at the current cursor position and never erase the 
screen. 



-cA 

Divide the screen into N columns and wait after the last column. 
-pL 

Set page length to L; L accepts the scale factors i (inches) and 1 
(lines); default is lines. 

See Also 



pr(C) 
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450 

handle special functions of the DASI 450 terminal 

Syntax 

450 

Description 



The 450 command supports special functions of, and optimizes the 
use of, the DASI 450 terminal, or any terminal that is functionally 
identical, such as the Diablo 1620 or Xerox 1700. It converts half-line 
forward, half-line reverse, and full-line reverse motions to the correct 
vertical motions. It also attempts to draw Greek letters and other spe- 
cial symbols in the same manner as 300 {C). It should be noted that, 
unless your system contains text processing software, certain com- 
mands (e.g., eqn, nrojf, tbl, etc.) will not work. Use 450 to print 
equations neatly, in the sequence: 

neqn file ... | nroff | 450 

WARNING: Make sure that the PLOT switch on your terminal is ON 
before 450 is used. The SPACING switch should be put in the desired 
position (either 10- or 12-pitch). In either case, vertical spacing is 6 
lines/inch, unless dynamically changed to 8 lines per inch by an ap- 
propriate escape sequence. 

Use 450 with the nrojf -s flag or .rd requests when it is necessary to 
insert paper manually or change fonts in the middle of a document. 
Instead of hitting the return key in these cases, you must use the line- 
feed key to get any response. 

In many (but not all) cases, the use of 450 can be eliminated in favor 
of one of the following: 

nroff -T450 files . . . 
or 

nroff -T450-12 files ... 

The use of 450 can thus often be avoided unless special delays or 
options are required; in a few cases, however, the additional piove- 
ment optimization of 450 may produce better aligned output. 

See Also 



300(C), mesg(C), stty(C), tabs(C), graph(ADM), tplot(ADM) 
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Some special characters cannot be correctly printed in column 1 
because the print head cannot be moved to the left from there. 

If your output contains Greek and/or reverse line-feeds, use a friction- 
feed platen instead of a forms tractor; although good enough for drafts, 
the latter has a tendency to slip when reversing direction, distorting 
Greek characters and misaligning the first line of text after one or 
more reverse line-feeds. 
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assign, deassign 

assigns and deassigns devices 

Syntax 



assign [ -u ] [ -v ] [ -d ] [ device ] ... 
deassign [ -u ] [ -v ] [ device ] ... 

Description 



assign attempts to assign device to the current user. The device argu- 
ment must be an assignable device that is not currently assigned. An 
assign command without an argument prints a list of assignable de- 
vices along with the name of the user to whom they are assigned. 

deassign is used to “deassign” devices. Without any arguments, 
deassign will deassign all devices assigned to the user. When argu- 
ments are given, an attempt is made to deassign each device given as 
an argument. 

With these commands you can exclusively use a device, such as a tape 
drive or floppy drive. This keeps other users from using the device. 
They have a similar effect as chown(C) and chmod(C\ although they 
only act on devices in /dev. Other aspects are discussed further on. 

Available options include: 

-d Performs the action of deassign. The -d option can be embedded 
in device names to assign some devices and deassign others. 

-V Gives verbose output. 

-u Suppresses assignment or deassignment, but performs error check- 
ing. 

The assign command will not assign any assignable devices if it can- 
not assign all of them, deassign gives no diagnostic if the device can- 
not be deassigned. Devices can be automatically deassigned at 
logout, but this is not guaranteed. Device names can be just the begin- 
ning of the device required. For example, 

assign fd 

should be used to assign all floppy disk devices. Raw versions of de- 
vice will also be assigned, e.g., the raw floppy disk devices /dev/rfd? 
would be assigned in the above example. 
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Note that in many installations the assignable devices such as floppy 
disks have general read and write access, so the assign command may 
not be necessary. This is particularly true on single-user systems. De- 
vices supposed to be assignable with this command should be owned 
by the user asg . The directory /dev should be owned by bin and have 
mode 755. The assign command (after checking for use by someone 
else) will then make the device owned by whoever invokes the com- 
mand, without changing the access permissions. This allows the sys- 
tem administrator to set up individual devices that are freely avail- 
able, assignable (owned by asg), or nonassignable and restricted (not 
owned by asg and with some restricted mode). 

Note that the first time assign is invoked, it builds the assignable de- 
vices table /etc/atab. This table is used in subsequent invocations to 
save repeated searches of the /dev directory. If one of the devices in 
/dev is changed to be assignable or unassignable (i.e., owned by asg), 
then /etc/atab should be removed (by the super-user) so that a correct 
list will be built the next time the command is invoked. 

Files 



/etc/atab Table of assignable devices 
/dev/asglock File to prevent concurrent access 

Diagnostics 



Exit code 0 returned if successful, 1 if problems, 2 if device cannot be 
assigned. 
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at, batch 

executes commands at a later time 

Syntax 

at time [ date ] [ increment ] 
at -r job-id ... 
at -I[ job-id,,.] 

at -qletter time [ date ] [ increment ] 

batch 

Description 



at and batch both accept one or more commands from the standard 
input to be executed at a later time, at and batch differ in the way the 
set of commands, or job, is scheduled: at allows you to specify a time 
when the job should be executed, while batch executes the job when 
the system load level permits. After a job is queued with either com- 
mand, the program writes a job identifier (a number and a letter), 
along with the time the job will execute, to standard error. 

at takes the following arguments: 

time The time can be specified as 1, 2, or 4 digits. One- and two- 
digit numbers are taken to be hours, four digits to be hours and 
minutes. The time can alternately be specified as two numbers 
separated by a colon, meaning hounminute . A suffix am or pm 
can be appended; otherwise a 24-hour clock time is understood. 
The suffix Zulu can be used to indicate Greenwich Mean Time 
(GMT). The special names noon, midnight, and now are also 
recognized. 

date An optional date can be specified as either a month name fol- 
lowed by a day number (and possibly year number preceded by 
an optional comma) or a day of the week (fully spelled or abbre- 
viated to three characters). Two special “days,” today and 
tomorrow, are recognized. If no date is given, today is 
assumed if the given hour is greater than the current hour and 
tomorrow is assumed if it is less. If the given month is less 
than the current month (and no year is given), next year is 
assumed. 
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increment 

The time and optional date arguments can be modified with an 
increment argument of the form units" \ where n is an 
integer and units is one of the following: minutes, hours, days, 
weeks, months, or years. The singular form is ^so accepted, 
and “+1 unit"" can also be written “next unit"". Thus, legiti- 
mate commands include: 

at 0815am Jan 24 
at 8:15am Jan 24 
at now + 1 day 
at 5 pm Friday next week 



-r job-id ... 

Removes the specified job or jobs previously scheduled by the at 
or batch command, job-id is a job identifier returned by at or 
batch. Unless you are the super-user, you can only remove your 
own jobs. 



-1 [job-id ... ] 

Lists schedule times of specified jobs. If no job-ids are specified, 
lists all jobs currently scheduled for the invofong user. Unless you 
are the super-user, you can only list your own jobs. 



•qletter 

Places the specified job in a queue denoted by letter^ where letter 
is any lowercase letter from “a” to “z”. The queue letter is 
appended to the job identifier. The following letters have special 
significance: 

a at queue 
b batch queue 
c cron queue 



For more information on the use of different queues, see the 
queuedefs (F) manual page. 



batch takes no arguments; it submits a job for immediate execution at 
lower priority than an ordinary job. 



at and batch jobs are executed using sh{C). Standard output and stan- 
dard error output are mailed to the user unless they are redirected else- 
where. The shell environment variables, current directory, umask, and 
ulimit are retained when the commands are executed. Open file 
descriptors, traps, and priorities are lost. 



Users are permitted to use at and batch if their names appear in the 
file /usr/lib/cron/at.allow. If that file does not exist, the file 
/usr/lib/cron/at.deny is checked to determine if a given user should 
be denied access to at and batch. If neither file exists, only root is 
allowed to submit a job. If only the at.deny file exists, and it is empty, 
global usage is permitted. The allow/deny files consist of one user 
name per line. 
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The simplest way to use at is to place a series of commands in a file, 
one per line, and execute these commands at a specified time with the 
following command: 

at time < file 

The following sequence can be used at a terminal to format the file 
infile using the text formatter nrofi^CT), and place the output in the file 
outfile. 

batch 

nrofif infile > outfile 
(CTL)-d 

The next example demonstrates redirecting standard error to a pipe 
( I ), which is useful in a shell procedure. The file infile is formatted 
and the output placed in outfile, with any errors generated being 
mailed to user (output redirection is covered on the sh(C) manual 
page). 

batch «! 

nroff infile 2>&1 >outfile I mail user 

! 

To have a job reschedule itself, invoke at from within the job. For 
example, if you want shellfile to run every Thursday, executing a 
series of commands and then rescheduling itself for the next Thursday, 
you can include code similar to the following within shellfile: 

echo "sh shellfile" 1 at 1900 thursday next week 



Files 



/usr/lib/cron 
/usr/lib/ cron/at . allow 
/usr/lib/cron/at.deny 
/usr/lib/cron/queuedefs 
/usr/spool/cron/atjobs 



main cron directory 
list of allowed users 
list of denied users 
scheduling information 
spool area 
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See Also 



cron(C), kill(C), mail(C), nice(C), ps(C), sh(C), queuedefs(F) 

Diagnostics 



Complains about syntax errors and times out of range. 

Standards Conformance 



at and batch are conformant with: 

AT&TSVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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auths 

list and/or restrict kernel authorizations 

Syntax 



auths [ -V ] [ -a authlist ] [ -r authlist ] [ -c command ] 

Description 



auths performs actions associated with system privilege manipulation. 
With no arguments, auths returns the kernel authorizations associated 
with the current process. All other uses of auths are discussed below. 

Either of the -a or -r options allow the user to alter the kernel authori- 
zations in order to run a shell or a single command. The -a option 
requires a list of comma- separated authorizations, which become the 
absolute set of kernel authorizations for the new process. This new set 
must be a subset of the kernel authorizations of the invoking process. 
To start a process with a null set of kernel authorizations, use the 
empty string The -r option also takes as argument a comma 
separated list of authorizations. These are removed from the authori- 
zation set of the invoking process when forming the kernel authoriza- 
tions for the new process. 

The argument to the -c option is passed to the user’s shell as specified 
in the user’s /etc/pass wd entry which is run as a single command. The 
user’s shell must support the 

-c command 

syntax similar to sh{C). When the argument is absent (and -a or -r is 
specified), the user’s shell is invoked as a process with adjusted 
authorizations. Exiting that shell will resume execution in the previ- 
ous shell and the original kernel authorizations will be in effect. This 
option may be used to run a command with restricted authorizations, 
i.e. fewer than those allowed the user in the protected Password data- 
base entry. 

The -V option lists the new kernel authorizations before the new com- 
mand or shell is run. It also warns with the -a option when more 
authorizations are attempted to be set than already exist or with the -r 
option when more authorizations are attempted to be removed than 
already exist. 
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The kernel authorizations are: 

execsuid - allows the running of SUID programs 

nopromain - does not restrict file access when running SUID 

programs 

writeaudit - process can write directly to the audit trail 
configaudit - process can change audit subsystem parameters 
suspendaudit - process is not audited by the kernel 
chmodsugid - process can set SUID and GID bits on files 
chown - process can change file ownership 

Examples 



To execute a shell without the execsuid kernel authorization: 
auths -r execsuid 

To list the current kernel authorizations: 



auths 

To execute yourprog with no kernel authorizations: 
auths -a -c yourprog 

To execute myprog with chmodsugid and execsuid: 
auths -a chmodsugid, execsuid -c myprog 

See Also 

sh(C), promain(M), getpriv(S), setpriv(S), getprpwent(S), “Using a 
Trusted System” in the Users Guide 
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awk 

pattern scanning and processing language 

Syntax 

awk [ -F re ] [ parameter... ] [ ’prog’ ] [ -f progfile ] [ file... ] 

Description 



The -F re option defines the input field separator to be the regular 
expression re. 

Parameters, in the form x=... y=... may be passed to awk, where x and 
y are awk built-in variables (see list below). 

awk scans each input file for lines that match any of a set of patterns 
specified in prog. The prog string must be enclosed in single quotes 
(’) to protect it from the shell. For each pattern in prog there may be 
an associated action performed when a line of a file matches the pat- 
tern. The set of pattern-action statements may appear literally as prog 
or in a file specified with the -f progfile option. 

Input files are read in order; if there are no files, the standard input is 
read. The file name - means the standard input. Each input line is 
matched against the pattern portion of every pattern-action statement; 
the associated action is performed for each matched pattern. 

An input line is normally made up of fields separated by white space. 
(This default can be changed by using the FS built-in variable or the 
-F re option.) The fields are denoted $1, $2, ...; $0 refers to the entire 
line. 

A pattern-action statement has the form: 
pattern { action } 

Either pattern or action may be omitted. If there is no action with a 
pattern, the matching line is printed. If there is no pattern with an 
action, the action is performed on every input line. 

Patterns are arbitrary Boolean combinations ( !, | |, &&, and 
parentheses) of rational expressions and regular expressions. A rela- 
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tional expression is one of the following: 

expression relop expression 
expression matchop regular expression 

where a relop is any of the six relational operators in C, and a matchop 
is either ~ (contains) or ! ~ (does not contain). A conditional is an 
arithmetic expression, a relational expression, the special expression 

var in array, 

or a Boolean combination of these. 

The special patterns BEGIN and END may be used to capture control 
before the first input line has been read and after the last input line has 
been read respectively. 

Regular expressions are as in egrep (see grep(C)). In patterns they 
must be surrounded by slashes. Isolated regular expressions in a pat- 
tern apply to the entire line. Regular expressions may also occur in 
relational expressions. A pattern may consist of two patterns 
separated by a comma; in this case, the action is performed for all 
lines between an occurrence of the first pattern and next occurrence of 
the second pattern. 

A regular expression may be used to separate fields by using the -F re 
option or by assigning the expression to the built-in variable FS . The 
default is to ignore leading blanks and to separate fields by blanks 
and/or tab characters. However, if FS is assigned a value, leading 
blanks are no longer ignored. 

Other built-in variables include: 

ARGC command line argument count 

ARGV command line argument array 

FILENAME name of the current input file 

FNR ordinal number of the current record in the current file 

FS input field separator regular expression (default blank) 

NF number of fields in the current record 

NR ordinal number of the current record 

OFMT output format for numbers (default %.6g) 

OFS output field separator (default blank) 

ORS output record separator (default new-line) 

RS input record separator (default new-line) 



March 1 5, 1 989 



AWK-2 




AWK (C) 



AWK (C) 



An action is a sequence of statements. A statement may be one of the 
following; 

if ( conditional ) statement [ else statement ] 

while ( conditional ) statement 

do statement while ( conditional ) 

for ( expression ; conditional ; expression ) statement 

for ( var in array ) statement 

delete array[subscript] 

break 

continue 

{ [ statement ] ... } 

expression # commonly variable = expression 
print [ expression-list ] [ >expression ] 
printf format [ , expression-list ] [ >expression ] 
next # skip remaining patterns on this input line 

exit [expr] # skip the rest of the input; exit status is expr 
return [expr] 

Statements are terminated by semicolons, new lines, or right braces. 
An empty expression-list stands for the whole input line. Expressions 
take on string or numeric values as appropriate, and are built using the 
operators +, -, *, /, %, and concatenation (indicated by a blank). The 
C operators ++, --, +=, -=, *=, /=, and %= are also available in 
expressions. Variables may be scalars, array elements (denoted x[i]), 
or fields. Variables are initialized to the null string or zero. Array 
subscripts may be any string, not necessarily numeric; this allows for a 
form of associative memory. String constants are quoted (”). 

The print statement prints its arguments on the standard output, or on 
a file if >expression is present, or on a pipe if | cmd is present. The 
arguments are separated by the current output field separator and ter- 
minated by the output record separator. The printf statement formats 
its expression list according to the format (see printfiS) in the 
Programmer' s Reference). 

awk has a variety of built-in functions: arithmetic, string, 

input/output, and general. 

The arithmetic functions are: atan2, cos, exp, int, log, rand, sin, sqrt, 
and srand. int truncates its argument to an integer, rand returns a ran- 
dom number between 0 and 1 . srand ( expr ) sets the seed value for 
rand to expr or uses the time of day if expr is omitted. 

The string functions are: 



gsubifor, repl, in) 

behaves like sub (see below), except that it replaces 
successive occurrences of the regular expression 
(like the ed global substitute command). 
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indexes, t) returns the position in string s where string t first 
occurs, or 0 if it does not occur at all. 

length(s) returns the length of its argument taken as a string, or 

of the whole line if there is no argument. 

match(Sy re) returns the position in string s where the regular 
expression re occurs, or 0 if it does not occur at all. 
RSTART is set to the starting position (which is the 
same as the returned value), and RLENGTH is set to 
the length of the matched string. 

split(s, a,fs) splits the string s into array elements a[l], a[2], a[n], 
and returns n. The separation is done with the regu- 
lar expression fs or with the field separator FS if fs is 
not given. 

sprintflfint, expr, expr , . . . ) 

formats the expressions according to the printJ{S) 
format given by/m/ and returns the resulting string. 

subifor, repl, in) substitutes the string repl in place of the first 
instance of the regular expression for in string in and 
returns the number of substitutions. If in is omitted, 
awk substitutes in the current record ($0). 

substr(s, m, n) returns the ^-character substring of s that begins at 
position m. 

The input/output and general functions are: 

closeifilename) closes the file or pipe named filename. 

cmd\getline pipes the output of cmd into getline; each successive 
call to getline returns the next line of output from 
cmd. 

getline sets $0 to the next input record from the current input 

file. 

getline <file sets $0 to the next record from file. 

getline var sets variable var instead. 

getline var <file sets var from the next record of file. 

system(cmd) executes cmd and returns to its exit status. 

All forms of getline return 1 for successful input, 0 for end of file, and 
-1 for an error. 
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awk also provides user-defined functions. Such functions may be 
defined (in the pattern position of a pattern-action statement) as 

function name(args,...) { stmts } 
func name(args,...) { stmts } 

Function arguments are passed by value if scalar and by reference if 
array name. Argument names are local to the function; all other vari- 
able names are global. Function calls may be nested and functions 
may be recursive. The return statement may be used to return a 
value. 

Examples 



Print lines longer than 72 characters: 
length > 72 

Print first two fields in opposite order: 

{ print $2, $1 } 

Same, with input fields separated by comma and/or blanks and tabs: 

BEGIN { FS = [ \t]*[ \t]+" } 

{ print $2, $1 } 

Add up the first column, print sum and average: 

{ s += $1 } 

END { print "sum is", s, " average is", s/NR } 

Print fields in reverse order: 

{ for (i = NF; i > 0; --i) print $i } 

Print all lines between start/stop pairs: 

/start/, /stop/ 

Print all lines whose first field is different from previous one: 

$1 != prev { print; prev = $1 } 
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Simulate echo(C): 



BEGIN { 

for (i = 1; i < ARGC; i++) 

print f "%s", ARGV[i] 
printf "\n” 
exit 
} 



Print file, filling in page numbers starting at 5: 

/Page/ { $2 = n++; } 

{ print } 

command line: avvk -f program n=5 input 

See Also 



grep(C), sed(C), lex(CP), printf(S) 

Notes 



Input white space is not preserved on output if fields are involved. 

There are no explicit conversions between numbers and strings. To 
force an expression to be treated as a number add 0 to it; to force it to 
be treated as a string concatenate the null string (" ") to it. 

Standards Conformance 



awk is conformant with: 

AT&TSVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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banner 

prints large letters 
Syntax 

banner strings 

Description 



banner prints its arguments (each up to 10 characters long) in large 
letters on the standard output. This is useful for printing names at the 
front of printouts. 

See Also 



echo(C) 

Standards Conformance 



banner is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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basename 

removes directory names from pathnames 

Syntax 



basename string [ suffix ] 

Description 



basename deletes any prefix ending in / and the sujfix (if present in 
string) from string, and prints the result on the standard output. The 
result is the “base” name of the file, i.e., the filename without any 
preceding directory path and without an extension. It is used inside 
substitution marks in shell procedures to construct new 

filenames. 

The related command dirname deletes the last level from string and 
prints the resulting path on the standard output. 

Examples 



The following command displays the filename memos on the standard 
output: 

basename /usr/johnh/memos.old .old 

The following shell procedure, when invoked with the argument 
/usr/src/cmd/cat.c, compiles the named file and moves the output to a 
file named cat in the current directory: 

cc $1 

mv a.out ^basename $1 .c^ 

See Also 



dimame(C), sh(C) 

Standards Conformance 



basename is conformant with: 

The X/Open Portability Guide II of January 1987. 
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be 

invokes a calculator 

Syntax 

be [ -c ] [ -1 ] [ file ... ] 

Description 



be is an interactive processor for a language that resembles C but pro- 
vides unlimited precision arithmetic. It takes input from any Mes 
given, then reads the standard input. The -1 argument stands for the 
name of an arbitrary precision math library. The syntax for be pro- 
grams is as follows: L means the letters a-z, E means expression, S 
means statement. 

Comments: 

Enclosed in /* and */ 

Names: 

Simple variables: L 
Array elements: L [ E ] 

The words “base”, “ibase”, “obase”, and “scale”; “base” and 
“ibase” are interchangeable. 

Other operands: 

Arbitrarily long numbers with optional sign and decimal point 
(E) 

sqrt ( E ) 

length ( E ) Number of significant decimal digits 
scale ( E ) Number of digits right of decimal point 
L(E,...,E) 

Additive operators: 

+ 



Multiplicative operators: 

♦ 

/ 

% (remainder) 

" (exponentiation) 
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Unary operators: 

++ 

(prefix and postfix; apply to names) 
Relational operators: 

<= 

>= 

1 = 

< 

> 

Assignment operators: 



=+ 



=* 




Statements: 

E 

{ S ; ; S } 

if(E)S 

while ( E ) S 

for ( E ; E ; E ) S 

null statement 

break 

quit 

Function definitions: 

define L ( L,...,L ) { 
auto L, ... , L 
S; ...S 
return ( E ) 

} 
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Functions in 


-1 math library: 


s(x) 


Sine 


c(x) 


Cosine 


e(x) 


Exponential 


l(x) 


Log 


a(x) 


Arctangent 


j(n,x) 


Bessel function 


All function 


arguments are passed by value. 



The value of a statement that is an expression is printed unless the 
main operator is an assignment. Either semicolons or newlines may 
separate statements. Assignment to scale influences the number of 
digits to be retained on arithmetic operations in the manner of dc(C). 
Assignments to ibase or abase set the input and output number radix 
respectively. 

The same letter may be used as an array, a function, and a simple vari- 
able simultaneously. All variables are global to the program. “Auto” 
variables are pushed down during function calls. When using arrays 
as function arguments or defining them as automatic variables, empty 
square brackets must follow the array name. 

be is actually a preprocessor for dc(C), which it invokes automatical- 
ly, unless the -c (compile only) option is present. If the -c option is 
present, the dc input is sent to the standard output instead. 

Example 



The following defines a function to compute an approximate value of 
the exponential function: 

scale = 20 
define e (x) { 

auto a, b, c, i, s 
a = 1 
b = 1 
s = 1 

for(i=l; 1==1; i++) { 
a = a*x 
b = b*i 
c = a/b 

if (c == 0) return(s) 
s = s+c 



} 
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The following prints the approximate values of the exponential func- 
tion of the first ten integers: 

for{i=l; i<=10; i++) e(i) 



Files 



/usrAib/lib.bc 


Mathematical library 


/usr/bin/dc 


Desk calculator proper 


See Also 




dc(C) 

User’s Guide 




Notes 





A For statement must have all three E’s. 

Quit is interpreted when read, not when executed. 
Trigonometric values should be given in radians. 
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bdiff 

compares files too large for diff(C) 
Syntax 

bdiff filel file2 [ n ] [-S] 

Description 



bdiff compares two files, finds lines that are different, and prints them 
on the standard output. It allows processing of files that are too large 
for diff, bdiff splits each file into n-line segments, beginning with the 
first nonmatching lines, and invokes diff upon the corresponding seg- 
ments. The arguments are: 

n The number of lines splits each file into for processing. The 
default value is 3500. This is useful when 3500-line segments are 
too large for diff, 

-s Suppresses printing of M/y diagnostics. Note that this does not 
suppress printing of diagnostics from diff. 

If filel (or filel) is a dash (-), the standard input is read. 

The output of bdiff is exactly that of diff. Line numbers are adjusted to 
account for the segmenting of the files, and the output looks as if the 
files had been processed whole. 

Files 



/tmp/bd????? 

See Also 

diff(C) 

Notes 



Because of the segmenting of the files, bdiff dots not necessarily find a 
smallest sufficient set of file differences. 

Specify the maximum number of lines if the first difference is too far 
down in the file for diff md an error is received. 
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bfs 

scans big files 

Syntax 

bfs [ - ] name 

Description 



bfs is like ed (C) except that it is read-only and processes much larger 
files. Files can be up to 1024K bytes and 32K lines, with up to 255 
characters per line, bfs is usually more efficient than ed for scanning 
a file, since the file is not copied to a buffer. It is most useful for iden- 
tifying sections of a large file where csplit{C) can be used to divide it 
into more manageable pieces for editing. 

Normally, the size of the file being scanned is printed, as is the size of 
any file written with the w command. The optional dash (-) 
suppresses printing of sizes. Input is prompted for with an asterisk (*) 
when “P” and RETURN are typed. The “P” acts as a toggle, so 
prompting can be turned off again by entering another “P” and a 
RETURN. Note that messages are given in response to errors only if 
prompting is turned on. 

All address expressions described under ed are supported. In addition, 
regular expressions may be surrounded with two symbols other than 
the standard slash (/) and (?): A greater-than sign (>) indicates down- 
ward search without wraparound, and a less-than sign (<) indicates 
upward search without wraparound. Note that parentheses and curly 
braces are special and need to be escaped with a backslash (\). Since 
bfs uses a different regular expression-matching routine from ed, the 
regular expressions accepted are slightly wider in scope (see 
regex (S)). Differences between ed and bfs are listed below: 

+ A regular expression followed by + means one or more times . 

For example, [0-9]+ is equivalent to [0-9][0-9]*. 

\{m\} \{m,\} \{m,u\} 

Integer values enclosed in \{ \} indicate the number of times 
the preceding regular expression is to be applied, m is the 
minimum number and m is a number, less than 256, which is 
the maximum. If only m is present (e.g., \{m\}), it indicates 
the exact number of times the regular expression is to be 
applied. \{m,\) is analogous to \{m,infinity\}. The plus (+) 
and star (*) operations are equivalent to \{1,\} and \{0,\) 
respectively. 
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( . . . )$n The value of the enclosed regular expression is to be 
returned. The value will be stored in the (n-\-l )ih argument 
following the subject argument. At most ten enclosed regular 
expressions are allowed, regex makes its assignments uncon- 
ditionally. 

(...) Parentheses are used for grouping. An operator, e.g. +, 
\{ \}, can work on a single character or a regular expression 
enclosed in parenthesis. For example, \(a*\(cb+\)A)$0. 

There is also a slight difference in mark names: only the letters “a” 
through “z” may be used, and all 26 marks are remembered. 

The e, g, v, k, p, q, w, =, ! and null commands operate as described 
under ed except that e doesn’t remember filenames and g and v when 
given no arguments return the line after the line you were on. Com- 
mands such as ---, +++-, +++=, -12, and +4p are accepted. Note that 
IjlOp and 1,10 will both print the first ten lines. The f command only 
prints the name of the file being scanned; there is no remembered 
filename. The w command is independent of output diversion, trunca- 
tion, or crunching (see the xo, xt and xc commands, below). The fol- 
lowing additional commands are available: 

xf file 

Further commands are taken from the named file. When an 
end-of-file is reached, an interrupt signal is received, or an error 
occurs, reading resumes with the file containing the xf. xf com- 
mands may be nested to a depth of 10. 

xo [file ] 

Further output from the p and null commands is diverted to the 
named file. If file is missing, output is diverted to the standard 
output. Note that each diversion causes truncation or creation 
of the file. 

: label 

This positions a label in a command file. The label is ter- 
minated by a newline, and blanks between the : and the start of 
the label are ignored. This command may also be used to insert 
comments into a command file, since labels need not be refer- 
enced. 

( . , . )\h/regular expressionjlabel 

A jump (either upward or downward) is made to label if the 
command succeeds. It fails under any of the following condi- 
tions: 

1 . Either address is not between 1 and $. 

2. The second address is less than the first. 
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3. The regular expression doesn’t match at least one line 
in the specified range, including the first and last lines. 

On success, dot (.) is set to the line matched and a jump is made 
to label. This command is the only one that doesn’t issue an 
error message on bad addresses, so it may be used to test 
whether addresses are bad before other commands are executed. 
Note that the command 

xb/7 label 

is an unconditional jump. 

The xb command is allowed only if it is read from somewhere 
other than a terminal. If it is read from a pipe only a downward 
jump is possible. 

xt number 

Output from the p and null commands is truncated to a max- 
imum of number characters. The initial number is 255. 

[spaces] [value] 

The variable name is the specified digit following the xv. 
xvSlOO or xv5 100 both assign the value 100 to the variable 5. 
xv61,100p assigns the value l,100p to the variable 6. To refer- 
ence a variable, put a % in front of the variable name. For 
example, using the above assignments for variables 5 and 6: 

l,%5p 

1,%5 

%6 

prints the first 100 lines. 
g/%5/p 

globally searches for the characters 100 and prints each line 
containing a match. To escape the special meaning of %, a \ 
must precede it. For example, 

gr.A%[cds]/p 

could be used to match and list lines containing print/ charac- 
ters, decimal integers, or strings. 

Another feature of the xv command is that the first line of output 
from a Altos UNIX System V command can be stored into a 
variable. 
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The only requirement is that the first character of value be a !. 
For example, 

xv5!cat junk 

Irmjunk 

lecho 

xv6!expr %6 + 1 

puts the current line in variable 5, prints it, and increments the 
variable 6 by one. To escape the special meaning of ! as the first 
character of value , precede it with a \. For example, 

xvTMdate 

stores the value !date into variable 7. 
xbz label 
xbn label 

These two commands test the last saved return code from the 
execution of an Altos UNIX System V command (^command) or 
nonzero value, respectively, and jump to the specified label. 
The two examples below search for the next five lines contain- 
ing the string size: 

XV 5 5 
:1 

/size/ 

xv5!expr %5 - 1 
!if0%5 1=0 exit 2 
xbn 1 
xv45 
:1 

/size/ 

xv4!expr %4 - 1 
!if0%4 = 0exit2 
xbz 1 



xc [switch ] 

If switch is 1, output from the p and null commands is crunched; 
if switch is 0, it is not. Without an argument, xc reverses switch. 
Initially switch is set for no crunching. Crunched output has 
strings of tabs and blanks reduced to one blank and blank lines 
suppressed. 

See Also 



csplit(C), ed(C), umask(C) 



March 11, 1990 



BFS-4 





BFS(C) 



BFS (C) 



Diagnostics 



? for errors in commands if prompting is turned off. Self-explanatory 
error messages when prompting is on. 



March 11, 1990 



BFS-5 





CAL (C) 



CAL (C) 



cal 

prints a calendar 

Syntax 

cal [[ month ] year] 

Description 



cal prints a calendar for the specified year. If a month is also speci- 
fied, a calendar for that month only is printed. If no arguments are 
specified, the current, previous, and following months are printed, 
along with the current date and time. The year must be a number 
between 1 and 9999; month must be a number between 1 and 12 or 
enough characters to specify a particular month. For example. May 
must be given to distinguish it from March, but S is sufficient to 
specify September. If only a month string is given, only that month of 
the current year is printed. 

Notes 



Beware that “cal 84“ refers to the year 84, not 1984. 

The calendar produced is that for England and her colonies. Note that 
England switched from the Julian to the Gregorian calendar in Sep- 
tember of 1752, at which time eleven days were excised from the year. 
To see the result of this switch, try “cal 9 1752“. 

Standards Conformance 



cal is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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calendar 

invokes a reminder service 

Syntax 



calendar [ - ] 

Description 



calendar consults the file calendar in the user’s current directory and 
mails him lines that contain today’s or tomorrow’s date. Most reason- 
able month-day dates, such as “Sep. 14,’’ “September 14”, and 
“9/14”, are recognized, but not “14 September”, or “14/9”. 

On weekends “tomorrow” extends through Monday. Lines that con- 
tain the date of a Monday will be sent to the user on the previous Fri- 
day. This is not true for holidays. 

When an argument is present, calendar does its job for every user who 
has a file calendar in his login directory and sends the result to the 
standard output. Normally this is done daily, in the early morning, 
under the control of cron (C). 

Files 



calendar 

/usr/lib/calprog To figure out today’s and tomorrow’s dates 

/etc/passwd 

/tmp/cal* 

See Also 

cron(C), mail(C) 

Notes 

To get reminder service, a user’s calendar file must have read permis- 
sion for all. 
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Standards Conformance 



ca/emfctr is conformant with: 

AT&TSVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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cat 

concatenates and displays files 

Syntax 

cat [ -u ] [ -s ] [ -V ] [ -t ] [ -e ] file . . . 

Description 



cat reads each file in sequence and writes it on the standard output. If 
no input file is given, or if a single dash (-) is given, cat reads from the 
standard input. The options are: 

-s Suppresses warnings about nonexistent files. 

-u Causes the output to be unbuffered. 

-V Causes non-printing characters (with the exception of tabs, new- 
lines, and form feeds) to be displayed. Control characters are dis- 
played as (Ctrl-X), where X is the key pressed with the Ctrl 
key (for example, Ctrl-M is displayed as "M). The DEL character 
(octal 0177) is printed as Non-ASCII characters (with the 

high bit set) are printed as “M -x,” where x is the character 
specified by the seven low order bits. 

-t Causes tabs to be printed as “T’ and form feeds as “"L”. This 
option is ignored if the -v option is not specified. 

-e Causes a character to be printed at the end of each line (prior 
to the new-line). This option is ignored if the -v option is not set. 

No input file may have the same name as the output file unless it is a 
special file. 

Examples 



The following example displays file on the standard output: 
cat file 
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The following example concatenates file! and file! and places the 
result in fileS : 

cat filel file2 >file3 

The following example concatenates filel and appends it to file2 : 
cat filel » file2 

See Also 



cp(C), pr(C) 

Warning 



Command lines such as: 
cat filel file2 > filel 

will cause the original data in filel to be lost; therefore, you must be 
careful when using special shell characters. 

Standards Conformance 



cat is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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cd 

changes working directory 

Syntax 



cd [ directory ] 

Description 



If specified, directory becomes the new working directory; otherwise 
the value of the shell parameter $HOME is used. The process must 
have search (execute) permission in all directories (components) 
specified in the full pathname of directory . 

Because a new process is created to execute each command, cd would 
be ineffective if it were written as a normal command; therefore, it is 
recognized and executed by the shell. 

If the shell is reading its commands from a terminal, and the specified 
directory does not exist (or some component cannot be searched), 
spelling correction is applied to each component of directory, in a 
search for the “correct’ ’ name. The shell then asks whether or not to 
try and change directory to the corrected directory name; an answer of 
n means “no”, and anything else is taken as “yes”. 

Notes 



Wildcard designators will work with the cd command. 

See Also 



pwd(C), sh(C), chdir(S) 
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checkmail 

checks for mail which has been submitted but not 
delivered 

Syntax 



checkmail [ -a ] [ -f ] [ -m ] 

Description 



checkmail checks the mail queue on the local machine for messages 
which have been sent by the invoker. If invoked without any argu- 
ments, the “Subject:” of each message found is given along with a 
list of addressees that have not yet received the message. Usually, 
messages are still in the queue because the addressee’s host is down. 

The -a (all addresses) option causes all addresses to be shown (both 
delivered and undelivered). Some delivered addresses may not appear 
since some sites prune already delivered addresses from the address 
list files for efficiency. The -f (fast) option suppresses the printing of 
the “Subject” line. The -m (all messages) option causes checkmail to 
check all messages in the mail queue, not just those of the invoker. 
This is only useful for mail system maintainers who wish to find 
obstinate hosts. 

See Also 



send(ADM), deliver(ADM), mmdf(ADM) 
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chgrp 

changes group ID 

Syntax 

chgrp group file ... 

Description 



chgrp changes the group ID of each file to group. The group may be 
either a decimal group ID or a group name found in the file /etc/group. 

Fiies 



/etc/passwd 

/etc/group 

See Aiso 



chown(C), chown(S), passwd(F), group(F) 

Notes 



Only the owner or the super-user can change the group ID of a file. 

Standards Conformance 



chgrp is conformant with: 

AT&T SVID Issue 2, Select Code 301 -121 \ 

and The X/Open Portability Guide II of January 1987. 
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chmod 

changes the access permissions of a file or directory 

Syntax 



chmod mode file 

chmod [who] [+1-1=] [permission ...] file ... 

Description 



The chmod command changes the access permissions (or mode) of a 
specified file or directory. It is used to control file and directory 
access by users other than the owner and super-user. The mode may 
be an expression composed of letters and operators (called symbolic 
mode), or a number (called absolute mode). 

A chmod command using symbolic mode has the form: 

chmod [who] [+1-1=] [permission ...] filename 

In place of who you can use one or any combination of the following 
letters: 

a Stands for “all users”. If who is not indicated on the command 
line, a is the default. The definition of “all users” depends on the 
user’s umask. See umaskiQ). 

g Stands for “group”, all users who have the same group ID as the 
owner of the file or directory. 

o Stands for “others”, all users on the system. 

u Stands for “user”, the owner of the file or directory. 

The operators are: 

+ Adds permission 

- Removes permission 

= Assigns the indicated permission and removes all other permis- 
sions (if any) for that who. If no permission is assigned, existing 
permissions are removed. 
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Permissions can be any combination of the following letters: 

X Execute (search permission for directories) 
r Read 
w Write 

s Sets owner or group ID on execution of the file to that of the owner 
of the file. The mode “u+s” sets the user ID bit for the file. The 
mode “g+s” sets the group ID bit. Other combinations have no 
effect. When the group ID bit is set on a directory, all files created 
under it thereafter receive the group ID of that directory. When 
the group ID bit is not set, files are created with the group ID of the 
creating process/user. 

t This is known as the “sticky bit.” (see chmod{S)). Only the mode 
“u+t” sets the sticky bit. All other combinations have no effect. 
When this bit is set on a directory, files within the directory cannot 
be removed by anyone but the owner or the super-user. The owner 
can set or remove the sticky bit. 

1 Mandatory locking will occur during access 

Multiple symbolic modes may be given, separated by commas, on a 
single command line. See the following Examples section for sample 
permission settings. 

Mandatory file and record locking refers to a file having locked read- 
ing or writing permissions while a program is accessing that file. A file 
cannot have group execution permission and be able to be locked on 
execution. In addition, it is not possible to turn on the set-group-ID 
and enable a file to be locked on execution at the same time. The fol- 
lowing examples show illegal uses of chmod and will generate error 
messages: 

chmod g+x,+l filename 
chmod g+s,+l filename 

A chmod command using absolute mode has the form: 
chmod mode filename 

where mode is an octal number constructed by performing logical OR 
on the following: 

4000 Set user ID on execution 

20#0 Set group ID on execution if “#” is 7, 5, 3, or 1 and 
enable mandatory locking if “#” is 6, 4, 2, or 0. 
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1000 


Sets the sticky bit (see chmod(S)) 


0400 


Read by owner 


0200 


Write by owner 


0100 


Execute (search in directory) by owner 


0040 


Read by group 


0020 


Write by group 


0010 


Execute (search in directory) by group 


0004 


Read by others 


0002 


Write by others 


0001 


Execute (search in directory) by others 


0000 


No permissions 



Examples 



CHMOD (C) 



Symbolic Mode 

The following command gives all users execute permission for file: 
chmod +x file 

The following command removes read and write permission for group 
and others from file: 

chmod go-rw file 

The following command gives other users read and write permission 
for_^/^: 

chmod o+rw file 

The following command gives read permission to group and other: 
chmod g+r,o+r file 

Absolute Mode 
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The following command gives all users read, write and execute per- 
mission for file: 

chmod 0777 file 

The following command gives read and write permission to all users 
for file: 

chmod 0666 file 

The following command gives read and write permission to the owner 
of file only: 

chmod 0600 file 

The following example causes the file to be locked on access: 
chmod +1 file 

See Also 



ls(C), chmod(S) 

Notes 



The setuid, setgid and sticky bit settings have no effect on shell 
scripts. 

Standards Conformance 



chmod is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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chown 

changes owner ID 

Syntax 



chown owner file ... 

Description 



chown changes the owner ID of the files to owner. The owner may be 
either a decimal user ID or a login name found in the file /etc/pass wd. 

Fiies 



/etc/passwd 

/etc/group 

See Aiso 



chgrp(C), chown(S), group(F), passwd(F) 

Notes 



Use of this utility is governed by the chown kernel authorization. If 
this authorization is not granted, ownership of files can only be 
changed by root. Restricted chown is required for NIST FIPS 151-1 
conformance. The chown authorization should not be assigned to 
users if you wish to conform to these requirements. 

Standards Conformance 



chown is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

NIST FIPS 151-1; 

and The X/Open Portability Guide II of January 1987, 
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clear 

dears a terminal screen 

Syntax 



clear [ term ] 

Description 



The clear command clears the screen. If term is not specified, the ter- 
minal type is obtained from the TERM environment variable. 

If a video terminal does not have a clear screen capability, newlines 
are output to scroll the screen clear. If the terminal is a hardcopy, the 
paper is advanced to the top of the next page. 

Fiies 



/etc/termcap 

See Aiso 



environ(M), termcap(F), tput(C) 

Notes 



If the standard output is not a terminal, clear issues an error message. 
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cmchk 

reports hard disk block size 
Syntax 

cmchk 

Description 



Reports the hard disk block size in 512-byte blocks. 

Vaiue Added 



cmchk is an extension of AT&T System V provided by Altos UNIX 
System V. 
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cmp 

compares tvyo files 

Syntax 

cmp [ -I ] [ -s ] filel file2 

Description 



cmp compares two files and, if they are different, displays the byte and 
line number of the differences. If filel is the standard input is used. 

The options are: 

-1 Prints the byte number (decimal) and the differing bytes (octal) 
for each difference. 

-s Returns an exit code only, 0 for identical files, 1 for different 
files and 2 for an inaccessible or missing file. 

This command should be used to compare binary files; use diff(C) or 
to compare text files. 

See Aiso 



comm(C), difr(C), difB(C) 

Standards Conformance 



cmp is conformant with: 

AT&TSVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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col 

filters reverse linefeeds 

Syntax 



col [ -bfxp ] 

Description 



col prepares output from processes, such as the text formatter 
nrojf{CY), for output on devices that limit or do not allow reverse or 
half-line motions, col is typically used to process nroff output text 
that contains tables generated by the tbl program. A typical command 
line might be: 

tbl file I nroff I col I Ipr 
col takes the following options: 

-b Assumes the output device in use is not capable of backspacing. If 
two or more characters appear in the same place, col outputs the 
last character read. 

-f Allows forward half linefeeds. If not given, col accepts half line 
motions in its input, but text that would appear between lines is 
moved down to the next full line. Reverse full and half linefeeds 
are never allowed with this option. 

-X Prevents conversion of whitespace to tabs on output, col normally 
converts whitespace to tabs wherever possible to shorten printing 
time. 

-p Causes col to ignore unknown escape sequences found in its input 
and pass them to the output as regular characters. Because these 
characters are subject to overprinting from reverse line motions, 
the use of this option is discouraged unless the user is fully aware 
of the position of the escape sequences. 

col assumes that the ASCII control characters SO (octal 016) and SI 
(octal 017) start and end text in an alternate character set. If you have 
a reverse linefeed (ESC 7), reverse half linefeed (ESC 8), or forward 
half linefeed (ESC 9), within an SI-SO sequence, the ESC 7, 8 and 9 
are still recognized as line motions. 

On input, the only control characters col accepts are space, backspace, 
tab, return, newline, reverse linefeed (ESC 7), reverse half linefeed 
(ESC 8), forward half linefeed (ESC 9), alternate character start(SI), 
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alternate character end (SO), and vertical tag (VT). (The VT charac- 
ter is an alternate form of full reverse linefeed, included for compati- 
bility with some earlier programs of this type.) All other nonprinting 
characters are ignored. 

See Also 



nroflF(CT), tbl(CT) 

Notes 



col cannot back up more than 128 lines. 

col allows at most 800 characters, including backspaces, on a line. 

Vertical motions that would back up over the first line of the document 
are ignored. Therefore, the first line must not contain any superscripts. 

Standards Conformance 



col is conformant with: 

AT&TSVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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comm 

selects or rejects lines common to two sorted files 

Syntax 

comm [ -123 ] filel file2 

Description 



comm reads filel and file2 , which should be ordered in ASCII collat- 
ing sequence (see sort (C)), and produces a three-column output: lines 
only in filel ; lines only in file! ; and lines in both files. The filename 
- means the standard input. 

Flags 1, 2, or 3 suppress printing of the corresponding column. Thus 
comm -12 prints only the lines common to the two files; comm -23 
prints only lines in the first file but not in the second; comm -123 is a 
no-op. 

See Aiso 



cmp(C), diff(C), sort(C), uniq(C) 

Standards Conformance 



comm is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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compress, uncompress, zcat 

compress data for storage, uncompress and display 
compressed files 

Syntax 



compress [-dfFqc] [-b bits] file 
uncompress [-fqc]^/^ 
zcat file 

Description 



compress takes a file and compresses it to the smallest possible size, 
creates a compressed output file, and removes the original file unless 
the -c option is present. Compression is achieved by encoding com- 
mon strings within the file, uncompress restores a previously 
compressed file to its uncompressed state and removes the 
compressed version, zcat uncompresses and displays a file on the stan- 
dard output. 

If no file is specified on the command line, input is taken from the 
standard input and the output is directed to the standard output. Output 
defaults to a file with the same filename as the input file with the suf- 
fix “.Z” or it can be directed through the standard output. The output 
files have the same permissions and ownership as the corresponding 
input files or the user's standcU*d permissions if output is directed 
through the standard output. 

If no space is saved by compression, the output file is not written 
unless the -F flag is present on the command line. 

Options 



The following options are available from the command line: 

-d Decompresses a compressed file. 

-c Writes output on the standard output and does not remove 

original file. 

‘hbits Specifies the maximum number of bits to use in encoding. 

-f Overwrites previous output file. 
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-F Writes output file even if compression saves no space, 

-q Generates no output except error messages, if any. 

See Also 



pack(C), ar(C), tar(C), cat(C) 
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copy 

copies groups of files 

Syntax 

copy [ option ] ... source ... dest 

Description 



The copy command copies the contents of directories to another direc- 
tory. It is possible to copy whole file systems since directories are 
made when needed. 

If files, directories, or special files do not exist at the destination, then 
they are created with the same modes and flags as the source. In addi- 
tion, the super-user may set the user and group ID. The owner and 
mode are not changed if the destination file exists. 

Note that there may be more than one source directory. If so, the 
effect is the same as if the copy command had been issued for each 
source directory with the same destination directory for each copy. 

Options do not have to be given as separate arguments, and may 
appear in any order, even after the other arguments. The options are: 

-a Asks the user before attempting a copy. If the response does 

not begin with a “y”, then a copy is not done. When used 
together with the -v option, it overrides the verbose option 
so that messages regarding the copy action are not dis- 
played. 

-1 Uses links instead whenever they can be used. Otherwise a 

copy is done. Note that links are never done for special files 
or directories. 

-n Requires the destination file to be new. If not, then the copy 
command does not change the destination file. The -n flag is 
meaningless for directories. For special files a -n flag is 
assumed (i.e., the destination of a special file must not 
exist). 

-o If set then every file copied has its owner and group set to 

those of the source. If not set, then the file’s owner is the 
user who invoked the program. 
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-m If set, then every file copied has its modification time and 
access time set to that of the source. If not set, then the 
modification time is set to the time of the copy. 

-r If set, then every directory is recursively examined as it is 

encountered. If not set then any directories that are found 
are ignored. 

-ad Asks the user whether a -r flag applies when a directory is 
discovered. If the answer does not begin with a “y”, then 
the directory is ignored. 

-V Messages are printed that reveal what the program is doing. 
If used with the -a option, the -a option is given priority so 
that it overrides the verlx)se option, and the copy action 
message is not displayed. 

Arguments to copy are: 

source This may be a file, directory or special file. It must exist. If 
it is not a directory, then the results of the command are the 
same as for the cp command. 

dest The destination must be either a file or directory name that 
is different from the source. 

If the source and destination are anything but directories, then copy 
acts just like a cp command. If both are directories, then copy copies 
each file into the destination directory according to the flags that have 
been set. 

Examples 



This command line verbosely copies all files in the current directory 
to /tmp/food: 

copy “V . /tmp/food 

The next command line copies all files, except for those that begin 
with a period (.), and copies the immediate contents of any child 
directories: 

copy * /tmp/logic 

This command is the same as the previous one, except that it recur- 
sively examines all subdirectories, and it sets group and ownership 
permissions on the destination files to be the same as the source files: 

copy -ro * /tmp/logic 
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COPY (C) COPY (C) 

Notes 



Special device files can be copied. When they are copied, any data 
associated with the specified device is not copi^. 
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cp 

copies files 

Syntax 



cp filel file2 
cp files directory 

Description 



There are two ways to use the cp command. With the first way, file I 
is copied to file2 . Under no circumstance can filel and filc2 be ident- 
ical. With the second way, directory is the location of a directory into 
which one or xnoxt files are copied. This directory must exist prior to 
the execution of the cp command. 

See Aiso 



copy(C), cpio(C), ln(C), mv(C), rm(C), chmod(S) 

Notes 



Special device files can be copied. If the file is a named pipe, then the 
data in the pipe is copied to a regular file. Similarly, if the file is a de- 
vice, then the file is read until the end-of-file is reached, and that data 
is copied to a regular file. It is not possible to copy a directory to a 
file. 

Standards Conformance 



cp is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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cpio 

copy file archives in and out 

Syntax 



cpio -o [ acBvV ] [ -C bufsize ] [ [-0 file ] [-K volumesize ] [-M mes- 
sage] ] 

cpio -i [ BcdmrtTuvVfsSb6k ] [-C bufsize ] [ [-1 file ] [-K volumesize ] 
[-M message] ] [pattern ... ] 

cpio -p [ adlmuvV ] directory 

Description 



cpio -o (copy out) reads the standard input to obtain a list of path 
names and copies those files onto the standard output together with 
path name and status information. Output is padded to a 512-byte 
boundary by default. 

cpio -/ (copy in) extracts files from the standard input, which is 
assumed to be the product of a previous cpio -o. Only files with 
names that match patterns are selected, patterns are regular expres- 
sions given in the filename-generating notation of sh{C). In patterns, 
metacharacters ?, *, and [...] match the slash (/) character, and 
backslash (\) is an escape character. A ! metacharacter means not. 
(For example, the !abc* pattern would exclude all files that begin with 
abc.) Multiple patterns may be sp^ified and if no patterns are speci- 
fied, the default for patterns is ♦ (i.e., select all files). Each pattern 
must be enclosed in double quotes otherwise the name of a file in the 
current directory is used. Extracted files are conditionally created and 
copied into the current directory tree based upon the options described 
below. The permissions of the files will be those of the previous cpio 
-o . The owner and group of the files will be that of the current user 
unless the user is super-user, which causes cpio to retain the owner 
and group of the files of the previous cpio -o . NOTE: If cpio -i tries 
to create a file that already exists and the existing file is the same age 
or newer, cpio will output a warning message and not replace the file. 
(The -u option can be used to unconditionally overwrite the existing 
file.) 

cpio -p (pass) reads the standard input to obtain a list of path names of 
files that are conditionally created and copied into the destination 
directory tree based upon the options described below. Archives of 
text files created by cpio are portable between implementations of 
UNIX System V. 
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The meanings of the available options are: 

-a Reset access times of input files after they have been copied. 
Access times are not reset for linked files when cpio -pla is 
specified. 

-b Reverse the order of the bytes within each word. Use only with the 
-i option. 

-B Input/output is to be blocked 5,120 bytes to the record. The default 
buffer size is 512 bytes when this and the -C options are not used. 
(-B does not apply to the pass option; -B is meaningful only with 
data directed to or from a character-special device, e.g., 
/dev/rdsk/f0ql5dt.) 

-c Write header information in ASCII character form for portability. 
Always use this option when origin and destination machines are 
different types. 

-C bufsize 

Input/output is to be blocked bufsize bytes to the record, where buf- 
size is replaced by a positive integer. The default buffer size is 512 
bytes when this and -B options are not used. (-C does not apply to 
the pass option; -C is meaningful only with data directed to or 
from a character-special device, e.g., /dev/rmt/cOsO.) When used 
with the -K option, bufsize is forced to be a IK multiple. 

-d directories are to be created as needed. 

-f Copy in all files except those in patterns. (See the paragraph on 
cpio -i for a description of patterns.) 

-Ifile 

Read the contents of file as input. If file is a character-special de- 
vice, when the first medium is full, replace the medium and type a 
carriage return to continue to the next medium. Use only with the 
-i option. 

-k Attempt to skip corrupted file headers and I/O errors that may be 
encountered. If you want to copy files from a medium that is cor- 
rupted or out of sequence, this option lets you read only those files 
with good headers. (For cpio archives that contain other cpio 
archives, if an error is encountered, cpio may terminate prema- 
turely. cpio will find the next good header, which may be one for a 
smaller archive, and terminate when the smaller archive’s trailer is 
encountered.) Used only with the -i option. 

-1 Whenever possible, link files rather than copying them. Usable 
only with the -p option. 
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-m 

Retain previous file modification time. This option is ineffective 
on directories that are being copied. 

-K volumesize 

Specifies the size of the media volume. Must be in IK blocks. For 
example, a 1.2 MB floppy disk has a volumesize of 1200. Must 
include the -C option with a bufsize multiple of IK. 

-M message 

Define a message to use when switching media. When you use the 
-O or -I options and specify a character- special device, you can 
use this option to define the message that is printed when you 
reach the end of the medium. One %d can be placed in the mes- 
sage to print the sequence number of the next medium needed to 
continue. 

•Ofile 

Direct the output of cpio to file. If file is a character- special de- 
vice, when the first medium is full, replace the medium and type a 
carriage return to continue to the next medium. Use only with the 
-o option. 

-r Interactively rename files. If the user types a null line, the file is 
skipped. If the user types a the original pathname will be 
copied. (Not available with cpio -p.) 

-s swap bytes within each half word. Use only with the -i option. 

-S Swap halfwords within each word. Use only with the -i option. 

-T Truncate long filenames to 14 characters. Use only with the -i 
option, 

-t Print a table of contents of the input. No files are created. 

-u Copy unconditionally (normally, an older file will not replace a 
newer file with the same name). 

-V verbose : causes a list of file names to be printed. When used with 
the -t option, the table of contents looks like the output of an Is -1 
command [see ls(C)]. 

-V SpecialWcTbosc: print a dot for each file seen. Useful to assure the 
user that cpio is working without printing out all file names. 

-6 Process an old (i.e., UNIX System Sixth Edition format) file. Use 
only with the -i option. 

NOTE: cpio assumes 4-byte words. 
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If cpio reaches end of medium (end of a diskette for example) when 
writing to (-o) or reading from (-i) a character- special device, and -O 
and -I are not used, cpio will print the message: 

If you want to go on, type device! file name when ready. 

To continue, you must replace the medium and type the character- 
special device name (/dev/rdsk/fOqlSdt for example) and a carriage 
return. You may want to continue by directing cpio to use a different 
device. For example, if you have two floppy drives, you may want to 
switch between them so cpio can proceed while you are changing the 
floppies. (A carriage return alone causes the cpio process to exit.) 

Examples 



The following examples show three uses of cpio. 

When standard input is directed through a pipe to cpio -o, it groups the 
files so they can be directed (>) to a single file (. . Inewfile). The -c 
option insures that the file will be portable to other machines. Instead 
of ls(C), you could use find(C), echo(C), cat(C), etc., to pipe a list of 
names to cpio. You could direct the output to a device instead of a 
file. 

Is I cpio -oc >.. Inewfile 

cpio -i uses the output file of cpio -o (directed through a pipe with cat 
in the example), extracts those files that match the patterns (memo/al, 
memo/b*), creates directories below the current directory as needed 
(-d option), and places the files in the appropriate directories. The -c 
option is used when the file is created with a portable header. If no 
patterns were given, all files from newfile would be placed in the 
directory. 

cat newfile | cpio -icd ''memolal " "memolb ^ " 

cpio -p takes the file names piped to it and copies or links (-1 option) 
those files to another directory on your machine {newdir in the exam- 
ple). The -d options says to create directories as needed. The -m 
option says retain the modification time. [It is important to use the 
-depth option of findiC) to generate path names for cpio. This elim- 
inates problems cpio could have trying to create files under read-only 
directories.] 

find . -depth -print | cpio -pdlmv newdir 

See Also 



cat(C), echo(C), find(C), ls(C), tar(C), cpio(F) 
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Notes 



CPIO (C) 



1) Path names are restricted to 256 characters. 

2) Only the super-user can copy special files. 

3) Blocks are reported in 512-byte quantities. 

4) If a file has 000 permissions, contains more than 0 characters of data, 
and the user is not root, the file will not be saved or restored. 

Standards Conformance 



cpio is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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cron 



executes commands scheduled by at, batch, and 
crontab 


Syntax 




/etc/cron 




Description 




cron is the clock daemon that executes commands at specified dates 
and times, cron processes jobs submitted with at{C)y batch{C\ and - 
crontab (C), cron never exits; the cron command usually appears in 
the /etc/rc2 scripts to be invoked by init(M) when the system is 
brought up in multi-user mode. 


Fiies 




/etc/default/cron 


cron logging default information 


/usrAib/cron 


main cron directory 


/usr/lib/cron/atj obs 


at directory 


/usr/spool/cron/crontabs 


crontab directory 


/usrAib/cron/log 


accounting information 


/usr/lib/cron/queuedefs 


cron data file 


/usr/lib/cron/.proto 


cron environment information 


See Also 




at(C), crontab(C), queuedefs(F), sh(C) 


Diagnostics 





A history of all actions by cron can be recorded in /usr/lib/cron/log. 
This logging occurs only if the variable CRONLOG is set to YES in 
/etc/default/cron. By default this value is set to NO and no logging 
occurs. If logging should be turned on, be sure to check the size of the 
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log file regularly. 

Standards Conformance 



cron is conformant with; 

AT&TSVID Issue 2, Select Code 307-127. 



March 15, 1989 



CRON-2 





CRONTAB (C) 



CRONTAB (C) 



crontab 



schedule commands to be executed at regular inter- 
vals 

Syntax 



crontab [ file ] 
crontab -r 
crontab -I 

Description 



The crontab command can be used to schedule commands to be exe- 
cuted at regular intervals. These commands are stored in the user’s 
crontab file, /usr/spool/cron/crontabs/w.s'^mame. Any output or 
errors generated by the commands are mailed to the user. 

If called with no options, crontab copies the specified file, or standard 
input if no file is specified, into the crontabs directory (if the user has 
a previous crontab file, it is replaced). 

The -r option removes the user’s crontab file from the crontab direc- 
tory. 

The -1 option lists the contents of the user’s crontab file. 

If the file /usr/lib/cron/cron.allow exists, only the users listed in that 
file are allowed to use crontab . If cron.allow does not exist, and the 
file /usr/lib/cron/cron.deny does, then all users not listed in 
cron.deny are allowed “access to crontab, with an empty cron.deny 
allowing global usage. If neither file exists, only the super user is 
allowed to submit a job. The allow/deny files consist of one user name 
per line. 

The crontabs files consist of lines of six fields each. The fields are 
separated by spaces or tabs. The first five are integer patterns that 
specify the minute (0-59), hour (0-23), day of the month (1-31), month 
of the year (1-12), and day of the week (0-6, with 0=Sunday). Each of 
these patterns may contain: 

- A number in the (respective) range indicated above 

- Two numbers separated by a minus (indicating an inclusive range) 
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- A list of numbers separated by commas (meaning all of these num- 
bers) 

- An asterisk (meaning all legal values) 

Note that the specification of days may be made by two fields (day of 
the month and day of the week). If both are specified as a list of ele- 
ments, both are adhered to. For example, 0 0 1,15 * 1 would run a 
command on the first and fifteenth of each month, as well as on every 
Monday. To specify days by only one field, the other field should be 
set to * (for example, 0 0**1 would run a command only on Mon- 
days). 

The sixth field is a string that is executed by the shell at the specified 
time(s). A % in this field is translated into a newline character. Only 
the first line (up to a % or end-of-line) of the command field is exe- 
cuted by the shell. The other lines are made available to the command 
as standard input. 

The shell is invoked from your $HOME directory with an argO of sh. 
Users who desire to have their .profile executed must explicitly do so 
in the crontab file, cron supplies a default environment for every 
shell, defining HOME, LOGNAME, SHELL ( =/bin/sh ), and 
PATH ( =/bin:/usr/bin: ). 

Examples 



An example crontabs file follows: 



0 4 ★ * 

15 4 ★ ★ 

30 4 1 * 

40 4 * ★ 

1,21,41 * * * 



* calendar - 

* find /usr/preserve -mtime +7 -exec rm -f { } ; 
1 /usr/lib/uucp/uuclean 

* find / -name '#*' -atime +3 -exec rm -f {} ; 

* (echo -n ' ' ; date; echo ) >/dev/console 



The lines in this example do the following: run the calendar program 
every night at 4:00 am, clear old files from the /etc/preserve directory 
every night at 4:15 am, clean up the uucp spool directory every Mon- 
day and the first of every month at 4:30 am, find and remove any old 
files with names beginning with every night at 4:40 am, and echo 
the current date and time to the console three times an hour at one 
minute, 21 minutes, and 41 minutes past the hour. 



Files 



/usr/lib/cron 



main cron directory 
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/usr/spool/cron/crontabs 
/usr/lib/cron/cron.allow 
/usr/lib/cron/cron .deny 
/usr/lib/cron/.proto 
/usr/lib/cron/queuedef s 

See Also 



crontab directory 

list of allowed users 

list of denied users 

cron environment information 

cron data file 



at(C), cron(C), sh(C) 

Diagnostics 



crontab exits and returns a value of 55 if it cannot allocate enough 
memory. If it exits for any other reason, it returns a value of 1. 

Notes 



crontab commands are executed by croniC). cron reads the files in 
the crontabs directory only on startup or when a new crontab is sub- 
mitted with the crontab command, so changes made to these files by 
hand will not take effect until the system is rebooted. Changes sub- 
mitted with the crontab command will take effect as soon as cron is 
free to read them (that is, when cron is not in the process of running a 
scheduled job or reading another newly submitted at{C) or crontab 
job.). 

Users who do not wish to have output from their commands mailed to 
them may want to redirect it to a file: 

0 * * * * who >> /tmp/whof ile 2> /dev/null 

The example above would append the output of the who{C) command 
to a file, and throw away any errors generated. For more details on 
output redirection, see the sh{C) manual page. 

Users should remember to redirect the standard output and standard 
error of their commands otherwise any generated output or errors will 
be mailed to the user. 

crontab will overwrite any previous crontab submitted by the same 
user. 
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Standards Conformance 



crontab is conformant with: 

AT&TSVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 



CRONTAB (C) 
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crypt 

encode/decode 

Syntax 

crypt [ password ] 
crypt [-k] 

Description 



The crypt command reads from the standard input and writes to the 
standard output. The password is a key that selects a particular 
transformation. If no argument is given, crypt demands a key from the 
terminal and turns off printing while the key is being typed in. If the 
-k option is used, crypt will use the key assigned to the environment 
variable CRYPTKEY. The crypt command encrypts and decrypts with 
the same key: 

crypt key <clear >cypher 
crypt key <cypher | pr 

Files encrypted by crypt are compatible with those treated by the edi- 
tors ed{C), edit(C), ex(C), and vi(C) in encryption mode. 

The security of encrypted files depends on three factors: the funda- 
mental method must be hard to solve; direct search of the key space 
must be infeasible; “sneak paths” by which keys or clear text can 
become visible must be minimized. 

The crypt command implements a one-rotor machine designed along 
the lines of the German Enigma, but with a 256-element rotor. 
Methods of attack on such machines are known, but not widely; more- 
over the amount of work required is likely to be large. 

The transformation of a key into the internal settings of the machine is 
deliberately designed to be expensive, i.e., to take a substantial frac- 
tion of a second to compute. However, if keys are restricted to (say) 
three lower-case letters, then encrypted files can be read by expending 
only a substantial fraction of five minutes of machine time. 

If the key is an argument to the crypt command, it is potentially visi- 
ble to users executing ps{C) or a derivative. To minimize this possi- 
bility, crypt takes care to destroy any record of the key immediately 
upon entry. The choice of keys and key security are the most vulner- 
able aspect of crypt . 



March 1 5, 1 989 



CRYPT-1 






CRYPT (C) 

Files 



CRYPT (C) 



/dev/tty for typed key 

See Also 



ed(C), edit(C), ex(C), makekey(C), ps(C), stty(C), vi(C) 

Notes 



If two or more files encrypted with the same key are concatenated and 
an attempt is made to decrypt the result, only the contents of the first 
of the original files will be decrypted correctly. 

Distribution of the crypt libraries and utilities is regulated by the U.S. 
Government and are not available to sites outside of the United States 
and its territories. Because we cannot control the destination of the 
software, these utilities are not included in the standard product. If 
your site is within the U.S. or its territories, you can obtain the crypt 
software through your product distributor or reseller. 
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csh 

invokes a shell command interpreter with C-iike syntax 

Syntax 



csh [ -cefinstvVxX ] [ arg ... ] 

Description 



csh is a command language interpreter. It begins by executing com- 
mands from the file .cshrc in the home directory of the invoker. If 
this is a login shell, it also executes commands from the file .login 
there. In the normal case, the shell begins reading commands from the 
terminal, prompting with % . Processing of arguments and the use of 
the shell to process files containing command scripts will be described 
later. 

The shell then repeatedly performs the following actions: a line of 
command input is read and broken into words. This sequence of words 
is placed on the command history list and then parsed. Finally, each 
command in the current line is executed. 

When a login shell terminates, it executes commands from the file 
.logout in the user’s home directory. 

Lexical structure 

The shell splits input lines into words at blanks and tabs with the fol- 
lowing exceptions. The characters &, !, ;, <, >, (, ), form separate 
words. If doubled in &&, I I , «, or », these pairs form single words. 
These parser metacharacters may be made part of other words, or their 
special meaning prevented, by preceding them with \. A newline pre- 
ceded by a \ is equivalent to a blank. 

In addition, strings enclosed in matched pairs of quotations, ' or ", 
form parts of a word; metacharacters in these strings, including blanks 
and tabs, do not form separate words. These quotations have seman- 
tics to be described subsequently. Within pairs of ' or " characters, a 
newline preceded by a \ gives a true newline character. 

When the shell’s input is not a terminal, the character # introduces a 
comment which continues to the end of the input line. It does not 
have this special meaning when preceded by \ and placed inside the 
quotation marks or ". 
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Commands 

A simple command is a sequence of words, the first of which specifies 
the command to be executed. A simple command or a sequence of 
simple commands separated by I characters forms a pipeline. The out- 
put of each command in a pipeline is connected to the input of the 
next. Sequences of pipelines may be separated by and are then exe- 
cuted sequentially. A sequence of pipelines may be executed without 
waiting for it to terminate by following it with a &. Such a sequence 
is automatically prevented from being terminated by a hangup signal; 
the nohup co.mmand need not be used. 

Any of the above may be placed in parentheses to form a simple com- 
mand (which may be a component of a pipeline, etc.) It is also possi- 
ble to separate pipelines with I I or && indicating, as in the C lan- 
guage, that the second is to be executed only if the first fails or 
succeeds respectively. (See Expressions.) 

Substitutions 

The following sections describe the various transformations the shell 
performs on the input in the order in which they occur. 

History Substitutions 

History substitutions can be used to reintroduce sequences of words 
from previous commands, possibly performing modifications on these 
words. Thus, history substitutions provide a generalization of a redo 
function. 

History substitutions begin with the character ! and may begin any- 
where in the input stream if a history substitution is not already in 
progress. The ! may be preceded by a \ to prevent its special meaning; 
a ! is passed unchanged when it is followed by a blank, tab, newline, 
=, or (. History substitutions may also occur when an input line begins 
with This special abbreviation will be described later. 

Any input line which contains history substitution is echoed on the 
terminal before it is executed as it could have been entered without 
history substitution. 

Commands input from the terminal which consist of one or more 
words are saved on the history list, the size of which is controlled by 
the history variable. The previous command is always retained. Com- 
mands are numbered sequentially from 1. 
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For example, enter the command: 
history 

Now, consider the following output from the history command: 

9 write michael 

10 ex write. c 

11 cat oldwrite.c 

12 diff *write.c 

The commands are shown with their event numbers. It is not usually 
necessary to use event numbers, but the current event number can be 
made part of the prompt by placing a ! in the prompt string. 

With the current event 13 we can refer to previous events by event 
number !1 1, relatively as in 1-2 (referring to the same event), by a pre- 
fix of a command word as in !d for event 12 or !w for event 9, or by a 
string contained in a word in the command as in !?mic? also referring 
to event 9. These forms, without further modification, simply reintro- 
duce the words of the specified events, each separated by a single 
blank. As a special case !! refers to the previous command; thus !! 
alone is essentially a redo. The form !# references the current com- 
mand (the one being entered). It allows a word to be selected from 
further left in the line, to avoid retyping a long name, as in !#:1. 

To select words from an event, we can follow the event specification 
by a : and a designator for the desired words. The words of an input 
line are numbered from 0, the first (usually command) word being 0, 
the second word (first argument) being 1, and so on. The basic word 
designators are: 

0 First (command) word 

n nth argument 

First argument, i.e. 1 

$ Last argument 

% Word matched by (immediately preceding) Is ? search 



x-y 

Range of words 
-y Abbreviates 0-y 

* Abbreviates "-$, or nothing if only 1 word in event 



March 1 5, 1 989 



CSH-3 




CSH (C) 



CSH (C) 



X * Abbreviates x -$ 

X - Like X * but omitting word $ 

The : separating the event specification from the word designator can 
be omitted if the argument selector begins with a ", $, *, - or %. After 
the optional word designator, a sequence of modifiers can be placed, 
each preceded by a The following modifiers are defined: 

h Removes a trailing pathname component 

r Removes a trailing .xxx component 

slUrl 

Substitutes / for r 

t Removes all leading pathname components 

& Repeats the previous substitution 

g Applies the change globally, prefixing the above 

p Prints the new command but does not execute it 

q Quotes the substituted words, preventing substitutions 

X Like q, but breaks into words at blanks, tabs, and newlines 

Unless preceded by a g, the modification is applied only to the first 
modifiable word. In any case it is an error for no word to be applica- 
ble. 

The left sides of substitutions are not regular expressions in the sense 
of the editors, but rather strings. Any character may be used as the de- 
limiter in place of /; a \ quotes the delimiter within the / and r strings. 
The character & in the right side is replaced by the text from the left. 
A \ quotes & also. A null I uses the previous string either from a / or 
from a contextual scan string s in llsl. The trailing delimiter in the 
substitution may be omitted if a newline follows immediately as may 
the trailing ? in a contextual scan. 

A history reference may be given without an event specification, e.g., 
!$. In this case the reference is to the previous command unless a pre- 
vious history reference occurred on the same line in which case this 
form repeats the previous reference. Thus !?foo?"!$ gives the first and 
last arguments from the command matching ?foo?. 

A special abbreviation of a history reference occurs when the first 
nonblank character of an input line is a ". This is equivalent to !:s", 
providing a convenient shorthand for substitutions on the text of the 
previous line. Thus "lb"lib fixes the spelling of lib in the previous 
command. Finally, a history substitution may be surrounded with { 
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and } if necessary to insulate it from the characters that follow. Thus, 
after Is -Id ~paul we might do ! {l}a to do Is -Id “paula, while !la would 
look for a command starting la. 

Quotations With ' and " 

The quotation of strings by " and ” can be used to prevent all or some 
of the remaining substitutions. Strings enclosed in ' are prevented any 
further interpretation. Variable and command expansion occurs in 
strings enclosed in 

In both cases, the resulting text becomes (all or part of) a single word; 
only in one special case (see Command Substitution below) does a ” 
quoted string yield parts of more than one word; ' quoted strings never 
do. 



Alias Substitution 

The shell maintains a list of aliases which can be established, dis- 
played and modified by the alias and unalias commands. After a com- 
mand line is scanned, it is parsed into distinct commands and the first 
word of each command, left-to-right, is checked to see if it has an 
alias. If it does, then the text which is the alias for that command is 
reread with the history mechanism available as though that command 
were the previous input line. The resulting words replace the com- 
mand and argument list. If no reference is made to the history list, 
then the argument list is left unchanged. 

Thus if the alias for Is is ‘is -1” the command ‘is /usr” would map to 
“Is -1 /usr”. Similarly if the alias for “lookup” was “grep \!" 
/etc/passwd” then “lookup bill” would map to “grep bill 
/etc/passwd”. 

If an alias is found, the word transformation of the input text is per- 
formed and the aliasing process begins again on the reformed input 
line. Looping is prevented if the first word of the new text is the same 
as the old by flagging it to prevent further aliasing. Other loops are 
detected and cause an error. 

Note that the mechanism allows aliases to introduce parser metasyn- 
tax. Thus we can alias print “"pr\!* I Ipr'” to make a command that 
paginates its arguments to the lineprinter. 

There are four csh aliases distributed. These are pushd, popd, swapd, 
and flipd. These aliases maintain a directory stack. 

pushd dir 

Pushes the current directory onto the top of the directory stack, 
then changes to the directory dir. 
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popd 

Changes to the directory at the top of the stack, then removes 
(pops) the top directory from the stack, and announces the current 
directory. 

swapd 

Swaps the top two directories on the stack. The directory on the 
top becomes the second to the top, and the second to the top direc- 
tory becomes the top directory. 

flipd 

Flips between two directories, the current directory and the top 
directory on the stack. If you are currently in dirl,and dir2 is on 
the top of the stack, when flipd is invoked, you change to dir2 and 
dirl is replaced as the top directory on the stack. When flipd is 
again invoked, you change to dirl and dir2 is again the top direc- 
tory on the stack. 



Variable Substitution 

The shell maintains a set of variables, each of which has a list of zero 
or more words as its value. Some of these variables are set by the 
shell or referred to by it. For instance, the argv variable is an image of 
the shell’s argument list, and words of this variable’s value are 
referred to in special ways. 

The values of variables may be displayed and changed by using the set 
and unset commands. Of the variables referred to by the shell a num- 
ber are toggles; the shell does not care what their value is, only 
whether they are set or not. For instance, the verbose variable is a tog- 
gle which causes command input to be echoed. The setting of this 
variable results from the -v command line option. 

Other operations treat variables numerically. The at-sign ((a)) com- 
mand permits numeric calculations to be performed and the result 
assigned to a variable. However, variable values are always 
represented as (zero or more) strings. For the purposes of numeric 
operations, the null string is considered to be zero, and the second and 
subsequent words of multiword values are ignored. 

After the input line is aliased and parsed, and before each command is 
executed, variable substitution is performed, keyed by dollar sign ($) 
characters. This expansion can be prevented by preceding the dollar 
sign with a backslash (\) except within double quotation marks (") 
where it always occurs, and within single quotation marks (') where it 
never occurs. Strings quoted by back quotation marks (') are inter- 
preted later (see Command substitution below) so dollar sign substitu- 
tion does not occur there until later, if at all. A dollar sign is passed 
unchanged if followed by a blank, tab, or end-of-line. 



March 1 5, 1 989 



CSH-6 




CSH (C) 



CSH (C) 



Input and output redirections are recognized before variable expan- 
sion, and are expanded separately. Otherwise, the command name and 
entire argument list are expanded together. It is thus possible for the 
first (command) word to generate more than one word, the first of 
which becomes the command name, and the rest of which become 
arguments. 

Unless enclosed in double quotation marks or given the :q modifier, 
the results of variable substitution may eventually be subject to com- 
mand and filename substitution. Within double quotation marks ("), a 
variable whose value consists of multiple words expands to a portion 
of a single word, with the words of the variable’s value separated by 
blanks. When the :q modifier is applied to a substitution, the variable 
expands to multiple words with each word separated by a blank and 
quoted to prevent later command or filename substitution. 

The following sequences are provided for introducing variable values 
into the shell input. Except as noted, it is an error to reference a vari- 
able which is not set. 

$name 

${name} 

Are replaced by the words of the value of variable namCy each 
separated by a blank. Braces insulate name from following 
characters which would otherwise be part of it. Shell variables 
have names consisting of up to 20 letters, digits, and under- 
scores. 

If name is not a shell variable, but is set in the environment, then that 
value is returned (but : modifiers and the other forms given below are 
not available in this case). 

$name[selector] 

${name[selector]} 

May be used to select only some of the words from the value of 
name. The selector is subjected to $ substitution and may con- 
sist of a single number or two numbers separated by a -. The 
first word of a variables value is numbered 1. If the first number 
of a range is omitted it defaults to 1. If the last member of a 
range is omitted it defaults to $#name. The selector * selects all 
words. It is not an error for a range to be empty if the second 
argument is omitted or in range. 

$#name 

${#name} 

Gives the number of words in the variable. This is useful for 
later use in a [selector]. 

$0 Substitutes the name of the file from which command input is being 
read. An error occurs if the name is not known. 
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$number 
${ number} 

Equivalent to $argv [number]. 

$* Equivalent to $argv[*]. 

The modifiers :h, :t, :r, :q and :x may be applied to the substitutions 
above as may :gh, :gt and :gr. If braces { } appear in the command 
form then the modifiers must appear within the braces. Only one : 
modifier is allowed on each $ expansion. 

The following substitutions may not be modified with : modifiers. 

$?name 

${?name} 

Substitutes the string 1 if name is set, 0 if it is not. 

$?0 Substitutes 1 if the current input filename is known, 0 if it is not. 

$$ Substitutes the (decimal) process number of the (parent) shell. 
Command and Filename Substitution 

Command and filename substitution are applied selectively to the 
arguments of built-in commands. This means that portions of expres- 
sions which are not evaluated are not subjected to these expansions. 
For commands which are not internal to the shell, the command name 
is substituted separately from the argument list. This occurs very late, 
after input-output redirection is performed, and in a child of the main 
shell. 

Command Substitution 

Command substitution is indicated by a command enclosed in back 
quotation marks. The output from such a command is normally bro- 
ken into separate words at blanks, tabs and newlines, with null words 
being discarded. This text then replaces the original string. Within 
double quotation marks, only newlines force new words; blanks and 
tabs are preserved. 

In any case, the single final newline does not force a new word. Note 
that it is possible for a command substitution to yield only part of a 
word, even if the command outputs a complete line. 



Filename Substitution 

If a word contains any of the characters *, ?, [ or { or begins with the 
character then that word is a candidate for filename substitution, 
also known as globbing. This word is then regarded as a pattern, and 
is replaced with an alphabetically sorted list of filenames which match 
the pattern. In a list of words specifying filename substitution it is an 
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error for no pattern to match an existing filename, but it is not required 
for each pattern to match. Only the metacharacters *, ?, and [ imply 
pattern matching. The characters ~ and { are more akin to abbrevia- 
tions. 

In matching filenames, the character . at the beginning of a filename or 
immediately following a /, as well as the character / must be matched 
explicitly. The character * matches any string of characters, including 
the null string. The character ? matches any single character. The 
sequence within square brackets [] matches any one of the characters 
enclosed. Within square brackets [], a pair of characters separated by 
- matches any character lexically between the two. 

The character at the beginning of a filename is used to refer to home 
directories. Standing alone, it expands to the invoker’s home directory 
contained in the variable HOME. When followed by a name consist- 
ing of letters, digits and - characters the shell searches for a user with 
that name and substitutes their home directory; thus Teen might 
expand to /usr/ken and ~ken/chmach to /usr/ken/chmach. If the charac- 
ter ~ is followed by a character other than a letter or /, or if it does not 
appear at the beginning of a word, it is left unchanged. 

The metanotation a{b,c,d]e is a shorthand for abe ace ade. Left to 
right order is preserved, with results of matches being sorted 
separately at a low level to preserve this order. Thus 

'“source/sl/{oldls,ls} .c expands to /usr/source/sl/oldls.c 
/usr/source/sl/ls.c, whether or not these files exist, assuming that the 
home directory for source is /usr/source. Similarly ../{memo,*box} 
might expand to ../memo ../box ../mbox. (Note that memo was not 
sorted with the results of matching *box.) As a special case {, } and 
{ } are passed unchanged. This construct can be nested. 



Spelling Checker 

If the local variable cdspell has been set, the shell checks spelling 
whenever you use cd to change directories. For example, if you 
change to a different directory using cd and misspell the directory 
name, the shell responds with an alternative spelling of an existing 
directory. Enter “y” and press RETURN (or just press RETURN) to 
change to the offered directory. If the offered spelling is incorrect, 
enter “n”, then retype the command line. In this example the csh(C) 
response is boldfaced: 



% cd /usr/spol/uucp 

/usr/spool/uucp? y 
ok 
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InputI Output 

The standard input and standard output of a command may be 
redirected with the following syntax: 

< name 

Opens file name (after variable, command and filename expan- 
sion) as the standard input. 

« word 

Reads the shell input up to a line which is identical to word. 
Word is not subjected to variable, filename or command substi- 
tution, and each input line is compared to word before any sub- 
stitutions are done on this input line. Unless a quoting 
backslash, double, or single quotation mark, or a back quotation 
mark appears in word, variable and command substitution is 
performed on the intervening lines, allowing \ to quote $,\and 
Commands which are substituted have all blanks, tabs, and new- 
lines preserved, except for the final newline which is dropped. 
The resulting text is placed in an anonymous temporary file 
which is given to the command as standard input. 

> name 
>! name 
>& name 
>&! name 

The file name is used as standard output. If the file does not 
exist, then it is created; if the file exists, it is overwritten. 

If the variable noclobher is set, then an error results if the file 
already exists or if it is not a character special file (e.g., a termi- 
nal or /dev/null). This helps prevent accidental destruction of 
files. In this case, the ! forms can be used to suppress this check. 

The forms involving & route the diagnostic output into the 
specified file as well as the standard output. Name is expanded 
in the same way as < input filenames are. 

» name 
»& name 
»! name 
»&! name 

Uses file name as standard output like > but places output at the 
end of the file. If the variable noclobber is set, then it is an error 
for the file not to exist unless one of the ! forms is given. Other- 
wise similar to >. 

If a command is run in the background (followed by &) then the 
default standard input for the command is the empty file /dev/null. 
Otherwise, the command receives the input and output parameters 
from its parent shell. Thus, unlike some previous shells, commands 
run from a file of shell commands have no access to the text of the 
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commands by default; rather they receive the original standard input 
of the shell. The « mechanism should be used to present inline data. 
This permits shell command scripts to function as components of pipe- 
lines and allows the shell to block read its input. 

Diagnostic output may be directed through a pipe with the standard 
output. Simply use the form I & rather than just I. 

Expressions 

A number of the built-in commands (to be described later) take 
expressions, in which the operators are similar to those of C, with the 
same precedence. These expressions appear in the exit, if, and 
while commands. The following operators are available: 

I I && I "&==!=<=>=<> « » 

+ -*/%!'“() 

Here the precedence increases to the right, == and !=, <=, >=, <, and 
>, « and », + and -, * / and % being, in groups, at the same level. 
The == and != operators compare their arguments as strings, all others 
operate on numbers. Strings which begin with 0 are considered octal 
numbers. Null or missing arguments are considered 0. The result of 
all expressions are strings, which represent decimal numbers. It is 
important to note that no two components of an expression can appear 
in the same word unless a word is adjacent to components of expres- 
sions which are syntactically significant to the parser (&!<>()), it 
should be surrounded by spaces. 

Also available in expressions as primitive operands are command exe- 
cutions enclosed in { and ) and file enquiries of the form -/ name 
where / is one of: 

r Read access 

w Write access 

X Execute access 
e Existence 

o Ownership 

z Zero size 

f Plain file 

d Directory 

Command and filename expansion is applied to the specified name, 
then the result is tested to see if it has the specified relationship to the 
real user. If the file does not exist or is inaccessible then all enquiries 
return false, i.e. 0. Command executions succeed, returning true, i.e. 
1, if the command exits with status 0, otherwise they fail, returning 
false, i.e. 0. 

If more detailed status information is required then the command 
should be executed outside of an expression and the variable status 
examined. 
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Control Flow 

The shell contains a number of commands which can be used to regu- 
late the flow of control in command files (shell scripts) and (in limited 
but useful ways) from terminal input. Due to the implementation, 
some restrictions are placed on the word placement for the foreach, 
switch, and while statements, as well as the if-then-else form of the if 
statement. Please pay careful attention to these restrictions in the 
descriptions in the next section. 

If the shell’s input is not seekable, the shell buffers up input whenever 
a loop is being read and performs seeks in this internal buffer to 
accomplish the rereading implied by the loop. (To the extent that this 
allows, backward goto commands will succeed on nonseekable 
inputs.) 

Built-In Commands 

Built-in commands are executed within the shell. If a built-in com- 
mand occurs as any component of a pipeline except the last, then it is 
executed in a subshell. 

alias 

alias name 
alias name wordlist 

The first form prints all aliases. The second form prints the alias 
for name. The final form assigns the specified wordlist as the 
alias of name; wordlist is command and filename substitution is 
applied to wordlist. Name is not allowed to be alias or unalias 



break 

Causes execution to resume after the end of the nearest enclos- 
ing foreach or while statement. The remaining commands on 
the current line are executed. Multilevel breaks are thus possi- 
ble by writing them all on one line. 

breaksw 

Causes a break from a switch, resuming after the endsw. 
case label: 

This is part of the switch statement discussed below. 



cd 

cd name 
chdir 

chdir name 

Changes the shell’s working directory to directory name. If no 
argument is given, it then changes to the home directory of the 
user. If name is not found as a subdirectory of the current direc- 
tory (and does not begin with /, ./, or ../), then each component of 
the variable cdpath is checked to see if it has a subdirectory 
name. Finally, if all else fails but name is a shell variable 
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whose value begins with /, then this is tried to see if it is a direc- 
tory. 

If cdspell has been set, the shell runs a spelling check as follows. If 
the shell is reading its commands from a terminal, and the specified 
directory does not exist (or some component cannot be searched), 
spelling correction is applied to each component of directory in a 
search for the “correct” name. The shell then asks whether or not to 
try and change the directory to the corrected directory name; an 
answer of n means “no,” and anything else is taken as “yes.” 

continue 

Continues execution of the nearest enclosing while or for each. 
The rest of the commands on the current line are executed. 

default: 

Labels the default case in a switch statement. The default 
should come after all case labels. 

echo wordlist 

The specified words are written to the shell’s standard output. A 
V causes the echo to complete without printing a newline. A \n 
in wordlist causes a newline to be printed. Otherwise the words 
are echoed, separated by spaces. 



else 

end 

endif 

endsw 

See the description of the foreach, if, switch, and while state- 
ments below. 

exec command 

The specified command is executed in place of the current shell. 



exit 

exit(expr) 

The shell exits either with the value of the status variable (first 
form) or with the value of the specified expr (second form). 

foreach name (wordlist) 

end 

The variable name is successively set to each member of 
wordlist and the sequence of commands between this command 
and the matching end are executed. (Both 
foreachmmo(wordlist) and end must appear alone on separate 
lines.) 

The built-in command continue may be used to continue the 
loop prematurely and the built-in command break to terminate it 
prematurely. When this command is read from the terminal, the 
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contents of the loop are read by prompting with ? until end is 
typed before any statements in the loop are executed. 

glob wordlist 

Like echo but no \ escapes are recognized and words are delim- 
ited by null characters in the output. Useful for programs which 
wish to use the shell to apply filename expansion to a list of 
words. 

goto word 

Filename and command expansion is applied to the specified 
word to yield a string of the form label:. The shell rewinds its 
input as much as possible and searches for a line of the form 
label: possibly preceded by blanks or tabs. Execution continues 
after the specified line. 

history 

Displays the history event list, 
if (expr) command 

If the specified expression evaluates true, then the single com- 
mand with arguments is executed. Variable substitution on 
command happens early, at the same time it does for the rest of 
the if command. Command must be a simple command, not a 
pipeline, a command list, or a parenthesized command list. 
Input/output redirection occurs even if expr is false, and com- 
mand is not executed. 

if (expr) then 

else if (expr2) then 

else 

endif 

If the specified expr is true then the commands before the first 
else are executed; else if expr2 true then the commands after 
the second then and before the second else are executed, etc. 
Any number of else-if pairs are possible; only one endif is 
needed. The else part is likewise optional. (The words else and 
endif must appear at the beginning of input lines; the if (expr) 
then must appear alone on its input line or after an else.) 

logout 

Terminates a login shell. The only way to log out if ignoreeof is 
set. 
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nice 

nice +number 

nice command 

nice -f number command 

The first form sets the nice for this shell to 4. By default, com- 
mands run under C-Shell have a “nice value” of 0. The second 
form sets the nice to the given number. The final two forms run 
command at priority 4 and number respectively. The super-user 
may specify negative niceness by using “nice -number ....” The 
command is always executed in a subshell, and the restrictions 
placed on commands in simple //statements apply. 

nohup 

nohup command 

The first form can be used in shell scripts to cause hangups to be 
ignored for the remainder of the script. The second form causes 
the specified command to be run with hangups ignored. Unless 
the shell is running in the background, nohup has no effect. All 
processes running in the background with & are automatically 
nohuptd. 

onintr 
onintr - 
onintr label 

Controls the action of the shell on interrupts. The first form 
restores the default action of the shell on interrupts which is to 
terminate shell scripts or to return to the terminal command 
input level. The second form, onintr, causes all interrupts to be 
ignored. The final form causes the shell to execute a goto label 
when an interrupt is received or a child process terminates 
because it was interrupted. 

In any case, if the shell is running in the background, interrupts 
are ignored whether any form of onintr is present or not. 

rehash 

Causes the internal hash table of the contents of the directories 
in the path variable to be recomputed. This is needed if new 
commands are added to directories in the path while you are 
logged in. 

repeat count command 

The specified command, which is subject to the same restric- 
tions as the command in the simple if statement above, is exe- 
cuted count times. I/O redirection occurs exactly once, even if 
count is 0. 



set 

set name 
set name=word 
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set name[index]=word 
set name=(wordlist) 

The first form of the command shows the value of all shell vari- 
ables. Variables which have other than a single word as value 
print as a parenthesized word list. The second form sets name to 
the null string. The third form sets name to the single word. The 
fourth form sets the indexth component of name to word; this 
component must already exist. The final form sets name to the 
list of words in wordlist. Command and filename expansion is 
applied in all cases. 

These arguments may be repeated to set multiple values in a 
single set command. Note however, that variable expansion 
happens for all arguments before any setting occurs. 

setenv name value 

Sets the value of the environment variable name to be value^ 
which must be a single string. Two useful environment vari- 
ables are TERM, the type of your terminal and SHELL, the shell 
you are using. 



shift 

shift variable 

In the first form, the members of argv are shifted to the left, dis- 
carding argv[l]. It is an error for argv not to be set or to have 
less than one word as a value. The second form performs the 
same function on the specified variable. 

source name 

The shell reads commands from name. Source commands may 
be nested, but if they are nested too deeply, the shell may run 
out of file descriptors. An error in a source at any level ter- 
minates all nested source commands, including the csh process 
from which source was called. If source is called from the login 
shell, it is logged out. Input during source commands is never 
placed on the history list. 

switch (string) 
case strl: 

breaksw 

default: 

breaksw 

endsw 

Command and filename substitution is applied to string. The 
each case label is successively matched against the result. Vari- 
able expansion is also applied to the case labels, so the file 
metacharacters *, ?, and [...] can be used. If none of the labels 
match before a default label is found, then the execution begins 
after the default label. Each case label and the default label 
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must appear at the beginning of a line. The command breaksw 
causes execution to continue after the endsw. Otherwise control 
may fall through case labels and default labels, as in C. If no 
label matches and there is no default, execution continues after 
the endsw. 



time 

time command 

With no argument, a summary of CPU time used by this shell 
and its children is printed. If arguments are given, the specified 
simple command is timed and a time summary as described 
under the time variable is printed. If necessary, an extra shell is 
created to print the time statistic when the command completes. 
command has the same restrictions as the simple if statement 
described above. 

umask 
umask value 

The file creation mask is displayed (no arguments) or set to the 
specified value (one argument). The mask is given in octal. 
Common values for the mask are 002 giving all access to the 
group and read and execute access to others, or 022 giving read 
and execute access to users in the group and all other users. 

unalias pattern 

All aliases whose names match the specified pattern are dis- 
carded. Thus, all aliases are removed by unalias *. It is not an 
error for nothing to be unaliased. 

unhash 

Use of the internal hash table to speed location of executed pro- 
grams is disabled. 

unset pattern 

All variables whose names match the specified pattern are 
removed. Thus, all variables are removed by unset *; this has 
noticeably distasteful side-effects. It is not an error for nothing 
to be unset. 

wait 

All child processes are waited for. If the shell is interactive, 
then an interrupt can disrupt the wait, at which time the shell 
prints names and process numbers of all children known to be 
outstanding. 

while (expr) 

end 

While the specified expression evaluates nonzero, the com- 
mands between the while and the matching end are evaluated. 
Break and continue may be used to terminate or continue the 
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loop prematurely. (The while (qx^x) and end must appear alone 
on their input lines.) Prompting occurs here the first time 
through the loop as for iho^foreach statement if the input is a ter- 
minal. 



@ 

@ name = expr 
@ name[index] = expr 

The first form prints the values of all the shell variables. The 
second form sets the specified name to the value of expr. If the 
expression contains <, >, & or 1 then at least this part of the 
expression must be placed within ( ). The third form assigns the 
value of expr to the indexih argument of name. Both name and 
its indexih component must already exist. 

The operators *=, +=, etc. are available as in C. The space 
separating the name from the assignment operator is optional. 
Spaces are mandatory in separating components of expr which 
would otherwise be single words. The space between @ and 
name is also mandatory. 

Special postfix ++ and - operators increment and decrement 
name respectively, i.e. @ i++. 

Predefined Variables 

The following variables have special meaning to the shell. Of these, 
argv, child, home, path, prompt, shell and status are always set by the 
shell. Except for child and status this setting occurs only at initializa- 
tion; these variables will not be modified unless done explicitly by the 
user. 

The shell copies the environment variable PATH into the variable 
path, and copies the value back into the environment whenever path is 
set. Thus it is not necessary to worry about its setting other than in the 
file .cshrc since inferior csh processes will import the definition of 
path from the environment. 



argv 



cdpath 



child 



Set to the arguments to the shell, it is from this vari- 
able that positional parameters are substituted, i.e., 
$1 is replaced by $argv[l], etc. argv[0] is not 
defined, but $0 is. 

Gives a list of alternate directories searched to find 
subdirectories in commands. 

The process number of the last command forked 
with &. This variable is unset when this process 
terminates. 
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echo Set when the -x command line option is given. 

Causes each command and its arguments to be 
echoed just before it is executed. For nonbuilt-in 
commands all expansions occur before echoing. 
Built-in commands are echoed before command and 
filename substitution, since these substitutions are 
then done selectively. 

histchars Can be assigned a two-character string. The first 

character is used as a history character in place of !, 
the second character is used in place of the " substi- 
tution mechanism. For example, set histchars=”,;" 
will cause the history characters to be comma and 
semicolon. 

history Can be given a numeric value to control the size of 

the history list. Any command which has been 
referenced in this many events will not be dis- 
carded. A history that is too large may run the shell 
out of memory. The last executed command is 
always saved on the history list. 

home The home directory of the invoker, initialized from 

the environment. The filename expansion of 
refers to this variable. 

ignoreeof If set, the shell ignores end-of-file from input de- 

vices that are terminals. This prevents a shell from 
accidentally being terminated by pressing Ctrl-D. 

mail The files where the shell checks for mail. This 

check is executed after each command completion. 
The shell responds with, “You have new mail” if 
the file exists with an access time not greater than 
its modify time. 

If the first word of the value of mail is numeric, it 
specifies a different mail checking interval: in 
seconds, rather than the default, which is 10 
minutes. 

If multiple mail files are specified, then the shell 
responds with “New mail in when there is 

mail in the file name. 

noclobber As described in the section InputlOutput, restric- 

tions are placed on output redirection to insure that 
files are not accidentally destroyed, and that » 
redirections refer to existing files. 
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noglob 



nonomatch 



path 



prompt 



shell 



status 



If set, filename expansion is inhibited. This is most 
useful in shell scripts which are not dealing with 
filenames, or after a list of filenames has been 
obtained and further expansions are not desirable. 

If set, it is not an error for a filename expansion to 
not match any existing files; rather, the primitive 
pattern is returned. It is still an error for the primi- 
tive pattern to be malformed, i.e., echo [ still gives 
an error. 

Each word of the path variable specifies a directory 
in which commands are to be sought for execution. 
A null word specifies the current directory. If there 
is no path variable, then only full pathnames will 
execute. The usual search path is /bin, /usr/bin, and 
., but this may vary from system to system. For the 
super-user, the default search path is /etc, /bin and 
/usr/bin. A shell which is given neither the -c nor 
the -t option will normally hash the contents of the 
directories in the path variable after reading .cshrc, 
and each time the path variable is reset. If new 
commands are added to these directories while the 
shell is active, it may be necessary to give the 
rehash command, or the commands may not be 
found. 

The string which is printed before reading each 
command from an interactive terminal input. If a ! 
appears in the string, it will be replaced by the 
current event number unless a preceding \ is given. 
Default is % , or # for the super-user. 

The file in which the shell resides. This is used in 
forking shells to interpret files which have execute 
bits set, but which are not executable by the system. 
(See the description of Nonbuilt-In Command Exe- 
cution below.) Initialized to the home of the shell. 

The status returned by the last command. If it ter- 
minated abnormally, then 0200 is added to the 
status. Built-in commands which fail return exit 
status 1 , otherwise these commands set status to 0. 
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time Controls automatic timing of commands. If set, 

then any command which takes more than this 
many cpu seconds will cause a line to be sent to the 
screen displaying user time, system time, real time, 
and a utilization percentage which is the ratio of 
user plus system times to real time. 

verbose Set by the -v command line option, causes the 

words of each command to be printed after history 
substitution. 



Nonbuilt-In Command Execution 

When a command to be executed is found to not be a built-in com- 
mand, the shell attempts to execute the command via exec{S), Each 
word in the variable path names a directory from which the shell will 
attempt to execute the command. If it is given neither a -c nor a -t 
option, the shell will hash the names in these directories into an inter- 
nal table so that it will only try an exec in a directory if there is a pos- 
sibility that the command resides there. This greatly speeds command 
location when a large number of directories are present in the search 
path. If this mechanism has been turned off (via unhash) y or if the 
shell was given a -c or -t argument, and for each directory component 
of path which does not begin with a /, the shell concatenates each 
directory component of path with the given command name to form a 
pathname of a file which it then attempts to execute. 

Parenthesized commands are always executed in a subshell. Thus 

(cd ; pwd) ; pwd 

prints the home directory; leaving you where you were and printing 
the name of the current directory, while 

cd ; pwd 

leaves you in the home directory. Parenthesized commands are 
always executed in a subshell. Thus 

(cd; pwd); pwd 

prints the home directory but leaves you in the original directory, 
while 



cd; pwd 

moves you to the home directory. 

If the file has execute permissions but is not an executable binary to 
the system, then it is assumed to be a file containing shell commands 
and a new shell is spawned to read it. 
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If there is an alias for shell then the words of the alias are prepended 
to the argument list to form the shell command. The first word of the 
alias should be the full pathname of the shell (e.g. $shell). Note that 
this is a special, late occurring, case of alias substitution, and only 
allows words to be prepended to the argument list without 
modification. 

Argument List Processing 

If argument 0 to the shell is - then this is a login shell. The flag argu- 
ments are interpreted as follows: 

-c Commands are read from the (single) following argument which 
must be present. Any remaining arguments are placed in argv. 

-e The shell exits if any invoked command terminates abnormally 
or yields a nonzero exit status. 

-f The shell will start faster, because it will neither search for nor 
execute commands from the file .cshrc in the invoker’s home 
directory. 

-i The shell is interactive and prompts for its top-level input, even 
if it appears to not be a terminal. Shells are interactive without 
this option if their input and output are terminals. 

-n Commands are parsed, but not executed. This may aid in syn- 
tactic checking of shell scripts. 

-s Command input is taken from the standard input. 

-t A single line of input is read and executed. A \ may be used to 

escape the newline at the end of this line and continue onto 
another line, 

-V Causes the verbose variable to be set, with the effect that com- 
mand input is echoed after history substitution. 

-X Causes the echo variable to be set, so that commands are echoed 
immediately before execution. 

■V Causes the verbose variable to be set even before .cshrc is exe- 
cuted. 

-X Causes the echo variable to be set even before .cshrc is exe- 
cuted. 

After processing the flag arguments, if arguments remain but none of 
the -c, -i, -s, or -t options were given, the first argument is taken as the 
name of a file of commands to be executed. The shell opens this file, 
and saves its name for possible resubstitution by $0. On a typical sys- 
tem, most shell scripts are written for the standard shell (see sh{C)). 
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The C shell will execute such a standard shell if the first character of 
the script is not a # (i.e. if the script does not start with a comment). 
Remaining arguments initialize the variable argv. 

Signal Handling 

The shell normally ignores quit signals. The interrupt and quit signals 
are ignored for an invoked command if the command is followed by 
&; otherwise the signals have the values which the shell inherited 
from its parent. The shells handling of interrupts can be controlled by 
onintr. By default, login shells catch the terminate signal; otherwise 
this signal is passed on to children from the state in the shell’s parent. 
In no case are interrupts allowed when a login shell is reading the file 
.logout. 

Files 



7.cshrc 


Read at by each shell at the beginning 
of execution 


/etc/cshrc 


Systemwide default cshrc file if none is present 


7.1ogin 


Read by login shell, after .cshrc at login 


7.1ogout 


Read by login shell, at logout 


/bin/sh 


Shell for scripts not starting with a # 


/tmp/sh* 


Temporary file for « 


/dev/null 


Source of empty file 


/etc/passwd 


Source of home directories for "name 



Limitations 



Words can be no longer than 512 characters. The number of argu- 
ments to a command which involves filename expansion is limited to 
1/6 the number of characters allowed in an argument list, which is 
5120, less the characters in the environment. Also, command substitu- 
tions may substitute no more characters than are allowed in an argu- 
ment list. 

To detect looping, the shell restricts the number of alias substitutions 
on a single line to 20. 

See Also 



access(S), exec(S), fork(S), pipe(S), signal(S), umask(S), wait(S), 
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a.out(F), environ(M) 

Credit 



This Utility was developed at the University of California at Berkeley 
and is used with permission. 

Notes 



Built-in control structure commands like foreach and while cannot be 
used with I , & or 

Commands within loops, prompted for by ?, are not placed in the his- 
tory list. 

It is not possible to use the colon (:) modifiers on the output of com- 
mand substitutions. 

The C-shell has many built-in commands with the same name and 
functionality as Bourne shell commands. However, the syntax of 
these C-shell and Bourne shell commands often differs. Two examples 
are the nice and echo commands. Be sure to use the correct syntax 
when working with these built-in C-shell commands. 

When a C-shell user logs in, the system reads and executes commands 
in letcicshrc before executing commands in the user’s $HOMEl.cshrc. 
You can, therefore, modify the C-shell environment for all users on the 
system by editing letcicshrc. 

During intervals of heavy system load, pressing the delete key while 
at a C-shell prompt (%) may cause the shell to exit. If csh is the login 
shell, the user is logged out. 

csh attempts to import and export the PATH variable for use with reg- 
ular shell scripts. This only works for simple cases, where the PATH 
contains no command characters. 



March 1 5, 1 989 



CSH-24 






CSPLIT (C) 



CSPLIT (C) 



csplit 

splits files according to context 

Syntax 

csplit [-s] [-k] [-f prefix] file argl [. . . argn] 

Description 



csplit reads file and separates it into n+1 sections, defined by the 
arguments argl . . . argn. By default the sections are placed in files 
xxOO . . . xx« {n may not be greater than 99). These sections get the 
following pieces oi file : 

00: From the start of file up to (but not including) the line refer- 

enced by argl . 

01: From the line referenced by argl up to the line referenced by 

arg2. 



n+1 : From the line referenced by argn to the end of file . 

The options to csplit are: 

-s csplit normally prints the character counts for each file creat- 
ed. If the -s option is present, csplit suppresses the printing 
of all character counts. 

-k csplit normally removes created files if an error occurs. If 
the -k option is present, csplit leaves previously created files 
intact. 

-f prefix If the -f option is used, the created files are named prefixQ^ 
. . . prefixn. The default is xxOO . . . xxn. 

The arguments (argl . . . argn) to csplit can be a combination of the 

following: 

Irexpl A file is to be created for the section from the current line 
down to (but not including) the line containing the regular 
expression rexp. The current line becomes the line contain- 
ing rexp . This argument may be followed by an optional + 
or - some number of lines (e.g., /Page/-5). 
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%rexp% This argument is the same as Irexpl, except that no file is 
created for the section. 

Inno A file is to be created from the current line down to (but not 
including) Inno, The current line becomes Inno. 

{num} Repeat argument. This argument may follow any of the 
above arguments. If it follows a rexp type argument, that 
argument is applied num more times. If it follows Inno, the 
file will be split every Inno lines {num times) from that 
point. 

Enclose all rexp type arguments that contain blanks or other charac- 
ters meaningful to the shell in the appropriate quotation marks. Regu- 
lar expressions may not contain embedded newlines, csplit does not 
affect the original file; it is the users responsibility to remove it. 

Examples 



csplit -f cobol file '/procedure division/' 7par5./' 7parl6./' 

This example creates four files, cobolOO . . . cobol03. After editing 
the “split” files, they can be recombined as follows: 

cat cobol0[0-3] > file 

Note that this example overwrites the original file, 
csplit -k file 100 (99) 

This example would split the file at every 100 lines, up to 10,000 lines. 
The -k option causes the created files to be retained if there are less 
than 10,000 lines; however, an error message would still be printed. 

csplit -k prog.c '%main(%' 7"}/+l' {20} 

Assuming that prog.c follows the normal C coding convention of end- 
ing routines with a } at the beginning of the line, this example will 
create a file containing each separate C routine (up to 21) in prog.c. 
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See Also 

ed(C), sh(C), regex(S) 

Diagnostics 

Self-explanatory except for: 
arg ~ out of range 

which means that the given argument did not reference a line between 
the current position and the end of the file. 

Standards Conformance 



csplit is conformant with: 

AT&TSVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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CU 

call another UNIX/XENIX system 

Syntax 



CU [ -sspeed ] [ -lline ] [ -h ] [ -t ] [ -xn ] [ -o I -e I -oe ] [ -n ] telno 
CU [ -s speed ] [ -h ] [ -xn ] [ [ -o 1 -e I -oe ] -1 line [ dir ] 

CU [ -h ] [ -xn ] [ -o I -e I -oe ] systemname 

Description 



CU calls up another UNIX system, a terminal, or possibly a non-UNIX 
system. It manages an interactive conversation with possible transfers 
of ASCII files. 

CU accepts the following options and arguments: 

-sspeed Specifies the transmission speed (150, 300, 600, 1200, 
2400, 4800, 9600, 19200, 38400). The default value is 
"Any” speed which will depend on the order of the lines 
in the /usr/lib/uucp/Devices file. A speed range can 
also be specified (for example, -sl200-4800). 

-lline Specifies a device name to use as the communication 

line. This can be used to override the search that would 
otherwise take place for the first available line having 
the right speed. When the -1 option is used without the 
-s option, the speed of a line is taken from the Devices 
file. When the -1 and -s options are both used together, 
cu will search the Devices file to check if the requested 
speed for the requested line is available. If so, the con- 
nection will be made at the requested speed; otherwise 
an error message will be printed and the call will not be 
made. The specified device is generally a directly con- 
nected asynchronous line (e.g., /de\/ityab) in which 
case a telephone number {telno) is not required. The 
specified device need not be in the /dev directory. If 
the specified device is associated with an auto dialer, a 
telephone number must be provided. Use of this option 
with systemname rather than telno will not give the 
desired result (see systemname below). 

-h Emulates local echo, supporting calls to other computer 

systems which expect terminals to be set to half-duplex 
mode. 
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-t Used to dial an ASCII terminal which has been set to 

auto answer. Appropriate mapping of carriage-return to 
carriage-return-line-feed pairs is set. 

-xn Causes diagnostic traces to be printed; it produces a 

detailed output of the program execution on stderr. The 
debugging level, n, is a single digit; -x9 is the most 
useful value. 

-n For added security, will prompt the user to provide the 

telephone number to be dialed rather than taking it 
from the command line. 

telno When using an automatic dialer, the argument is the 

telephone number with equal signs for secondary dial 
tone or minus signs placed appropriately for delays of 4 
seconds. 

systemname A UUCP system name may be used rather than a tele- 
phone number. In this case, cu will obtain an appropri- 
ate direct line or telephone number from 
/usr/lib/uucp/Systems. Note: the systemname option 
should not be used in conjunction with the -1 and -s 
options as cu will connect to the first available line for 
the system name specified, ignoring the requested line 
and speed. 

dir The keyword dir can be used with cu -1/m^, in order to 

talk directly to a modem on that line, instead of talking 
to another system via that modem. This can be useful 
when debugging or checking modem operation. Note: 
only users with write access to the Devices file are per- 
mitted to use cu Aline dir. 

In addition, cu uses the following options to determine communica- 
tions settings: 

-o If the remote system expects or sends 7-bit with odd parity. 

-e If the remote system expects or sends 7-bit with even parity. 

-oe 

If the remote system expects or sends 7-bit, ignoring parity and 
sends 7-bit with either parity. 

By default, cu expects and sends 8-bit characters without parity. If the 
login prompt received appears to contain incorrect 8-bit characters, or 
a correct login is rejected, use the 7-bit options described above. 

After making the connection, cu runs as two processes: the transmit 
process reads data from the standard input and, except for lines begin- 
ning with ", passes it to the remote system; the receive process accepts 
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data from the remote system and, except for lines beginning with ”, 
passes it to the standard output. Normally, an automatic DC3/DC1 
protocol is used to control input from the remote so the buffer is not 
overrun. Lines beginning with “ have special meanings. 

The transmit process interprets the following user initiated com- 
mands: 



terminate the conversation. 

! escape to an interactive shell on the local sys- 

tem. 

Icmd . . . run cmd on the local system (via sh -c). 

%cmd . . . run cmd locally and send its output to the 

remote system. 

■%cd change the directory on the local system. 

Note: ‘!cd will cause the command to be run 
by a sub-shell, probably not what was 
intended. 



■%take/rom [ to ] 



~%put from [ to ] 



'"'line 

break 



%debug 



i 



\ 



copy file from (on the remote system) to file 
to on the local system. If to is omitted, the 
from argument is used in both places. 

copy file /rom (on local system) to file to on 
remote system. If to is omitted, the from 
argument is used in both places. 

For both "'^^jtake and ~%put commands, as 
each block of the file is transferred, consecu- 
tive single digits are printed to the terminal. 

send the line "line to the remote system. 

transmit a BREAK to the remote system 
(which can also be specified as ”%b). 

toggles the -x debugging level between 0 and 
9 (which can also be specified as ”%d). 

prints the values of the termio structure vari- 
ables for the user’s terminal (useful for 
debugging). 

prints the values of the termio structure vari- 
ables for the remote communication line 
(useful for debugging). 
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“%nostop toggles between DC3/DC1 input control pro- 

tocol and no input control. This is useful in 
case the remote system is one which does not 
respond properly to the DC3 and DCl charac- 
ters. 

The receive process normally copies data from the remote system to 
its standard output. Internally the program accomplishes this by ini- 
tiating an output diversion to a file when a line from the remote begins 
with Data from the remote is diverted (or appended, if » is used) 
to file on the local system. The trailing ~> marks the end of the diver- 
sion. 

The use of “%put requires stty{C) and cat(C) on the remote side. It 
also requires that the current erase and kill characters on the remote 
system be identical to these current control characters on the local 
system. Backslashes are inserted at appropriate places. 

The use of “%take requires the existence of echo(S) and cat(C) on the 
remote system. Also, tabs mode (See stty(C)) should be set on the 
remote system if tabs are to be copied without expansion to spaces. 

When CU is used on systeml to connect to system! and subsequently 
used on systeml to connect to systemS, commands on systeml can be 
executed by using Executing a tilde command reminds the user of 
the local system uname. For example, uname can be executed on sys- 
tems 1, 2, and 3 as follows: 

uname 

system3 

~sy stem 1! uname 
systeml 

^system2! uname 
system2 

In general, causes the command to be executed on the original ma- 
chine, causes the command to be executed on the next machine in 
the chain. 

Examples 



To dial a system whose telephone number is 9 201 555 1212 using 
1200 baud (where dial tone is expected after the 9): 

CU -sl200 9=12015551212 

If the speed is not specified, “Any” is the default value. 

To login to a system connected by a direct line: 

CU -1 /dev/ttyXX 
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or 

CU -1 ttyXX 

To dial a system with the specific line and a specific speed: 

CU -si 200 -1 ttyXX 

To dial a system using a specific line associated with an auto dialer: 

CU -1 ttyXX 9=12015551212 
To use a system name: 

CU systemname 

To talk directly to an ACU (connect directly with the modem and 
enter modem commands manually): 

CU -IttyXX dir 

Files 



/usr/lib/uucp/Systems 
/usr/lib/uucp/Devices 
/usr/lib/uucpA-CK. .(tty-device) 

See Also 



cat(C), ct(C), echo(S), stty(C), uucp(C), uname(C) 

Diagnostics 



Exit code is zero for normal exit, otherwise, one. 
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The CU command does not do any integrity checking on data it 
transfers. Data fields with special cu characters may not be 
transmitted properly. Depending on the interconnection hardware, 
it may be necessary to use a to terminate the conversion even if 
stty 0 has been used. Non-printing characters are not dependably 
transmitted using either the “%put or “%take commands, cu 
between an IMBRl and a penril modem will not return a login 
prompt immediately upon connection. A carriage return will 
return the prompt. 

Notes 



There is an artificial slowing of transmission by cu during the 
“%put operation so that loss of data is unlikely. 

Standards Conformance 



CU is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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cut 

cuts out selected fields of each line of a file 

Syntax 



cut -c list [ filel file2 ...] 

cut -f list [-d char] [-s] Ifilel file2 ...] 

Description 



Use cut to cut out columns from a table or fields from each line of a 
file. The fields as specified by list can be fixed length, i.e., character 
positions as on a punched card (-c option), or the length can vary from 
line to line and be marked with a field delimiter character like tab (-f 
option), cut can be used as a filter. If no files are given, the standard 
input is used. 

The meanings of the options are: 

list A comma-separated list of integers (in increasing order), with 
an optional dash (-), indicates ranges, as in the -o option of 
nroff/troff for page ranges; e.g., 1,4,7; 1-3,8; -5,10 (short for 
1-5,10); or 3- (short for third through last field). 

‘Clist The list following -c (no space) specifies character positions 
(e.g., -cl-72 would keep the first 72 characters of each line). 

4 list The list following -f is a list of fields assumed to be separated 

in the file by a delimiter character (see -d ); e.g., -fl,7 copies 
the first and seventh field only. Lines with no field delimiters 
will be passed through intact (useful for table subheadings), 
unless -s is specified. 

-dchar The character following -d is the field delimiter (-f option 
only). Default is tab. Space or other characters with special 
meaning to the shell must be quoted. 

-s If the -f option is used, -s suppresses lines with no delimiter 
characters. Unless specified, lines with no delimiters will be 
passed through untouched. 

Either the -c or -f option must be specified. 
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Use grep(C) to make horizontal “cuts” (by context) through a file, or 
paste (C) to put files together horizontally. To reorder columns in a 
table, use cut and paste . 

Examples 



cut -d: -fl,5 /etc/passwd Maps user ID’s to names. 
name=^ who am i I cut -fl -d" 

Sets name to current login name. 



See Also 



grep(C), paste(C) 

Diagnostics 



line too long A line can have no more than 511 characters or 
fields. 

bad list for c I f option 

Missing -c or -f option or incorrectly specified list. 
No error occurs if a line has fewer fields than the list 
calls for. 

no fields The list is empty. 

Standards Conformance 



cut is conformant with: 

AT&TSVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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date 

prints and sets the date 

Syntax 



date [ -cms ] [ mmddhhmm[yy] ] [ +format ] 

Description 



If no argument is given, or if the argument begins with +, the current 
date and time are printed as defined by the locale. Otherwise, the 
current date is set. The first mm is the month number; dd is the day 
number in the month; hh is the hour number (24-hour system); the 
second mm is the minute number; yy is the last 2 digits of the year 
number and is optional. For example: 

date 10080045 

sets the date to Oct 8, 12:45 AM, if the local language is set to English. 
The current year is the default if no year is mentioned. The system 
operates in GMT. date takes care of the conversion to and from local 
standard and daylight time. 

If the argument begins with +, the output of date is under the control 
of the user. The format for the output is similar to that of the first 
argument to print/ (S). All output fields are of fixed size (zero padded 
if necessary). Each field descriptor is preceded by a percent sign (%) 
and will be replaced in the output by its corresponding value. A single 
percent sign is encoded by doubling the percent sign, i.e., by specify- 
ing All other characters are copied to the output without 

change. The string is always terminated with a newline character. 

Field Descriptors: 

n Inserts a newline character 

t Inserts a tab character 

m Month of year - 01 to 12 

d Day of month - 01 to 31 

y Last 2 digits of year - (X) to 99 

D Date as mm/dd/yy 
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H Hour-00to23 
M Minute - 00 to 59 
S Second - 00 to 59 
T Time as HH:MM:SS 
j Julian date - 001 to 366 
w Day of the week - Sunday = 0 
a Abbreviated weekday - Sun to Sat 
h Abbreviated month - Jan to Dec 
r Time in AM/PM notation 

Options 



-c Prints the current date and time from the hardware real-time 
clock. Thus, date -c mmddhhmmlyy] sets the real-time clock. 

-m Updates the year on the hardware real-time clock, if it is Janu- 
ary 1, and makes adjustments to the real-time clock if it is 
February 29 in a leap year. These dates are not automatically 
incremented. Be sure to use this option after midnight. The -m 
option determines if it is January 1 or February 29, and then 
updates the hardware real-time clock if necessary. For the -m 
option to work correctly, the software clock and the hardware 
clock should be within twelve hours of each other. Use cron(C) 
to execute date m each day. 

-s Sets (synchronizes) the system (i.e., software) clock to the 
current time and date from the hardware real-time clock. 

The operating system normally uses only the system (software) clock. 

It uses the hardware real-time clock only with the date command. 

Example 



The line 

date '+DATE: %m/%d/%y%nTIME: %H:%M:%S' 
generates as output: 
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DATE: 08/01/90 
TIME: 14:45:05 

Diagnostics 



no permission You aren’t the super-user and you are trying to 

change the date. 

bad conversion The date set is syntactically incorrect. 

bad format character The field descriptor is not recognizable. 

Standards Conformance 



date is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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dc 

invokes an arbitrary precision calculator 

Syntax 



dc [ file ] 

Description 



dc is an arbitrary precision arithmetic package. Ordinarily it operates 
on decimal integers, but you may specify an input base, output base, 
and a number of fractional digits to be maintained. The overall struc- 
ture of dc is a stacking (reverse Polish) calculator. If an argument is 
given, input is taken from that file until its end, then from the standard 
input. The following constructions are recognized: 

number 

The value of the number is pushed on the stack. A number is 
an unbroken string of the digits 0-9. It may be preceded by an 
underscore (_) to input a negative number. Numbers may con- 
tain decimal points. 

The top two values on the stack are added (+), subtracted (-), 
multiplied (*), divided (/), remaindered (%), or exponentiated 
Q. The two entries are popped off the stack and the result 
pushed on the stack in their place. Any fractional part of an 
exponent is ignored. 

The top of the stack is popped and stored into a register named 
jc, where x may be any character. If the s is capitalized, x is 
treated as a stack and the value is pushed on it. 

lx The value in register x is pushed on the stack. The register x is 
not altered. All registers start with zero value. If the 1 is capi- 
talized, register x is treated as a stack and its top value is 
popped onto the main stack. 

d The top value on the stack is duplicated. 

p The top value on the stack is printed. The top value remains 
unchanged, p interprets the top of the stack as an ASCII string, 
removes it, and prints it. 

f All values on the stack are printed. 
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q Exits the program. If executing a string, the recursion level is 
popped by two. If q is capitalized, the top value on the stack is 
popped and the string execution level is popped by that value. 

X Treats the top element of the stack as a character string and 
executes it as a string of dc commands. 

X Replaces the number on the top of the stack with its scale fac- 
tor. 

[ ... ] Puts the bracketed ASCII string onto the top of the stack. 

<x >x =JC 

The top two elements of the stack are popped and compared. 
Register x is evaluated if they obey the stated relation. 

V Replaces the top element on the stack by its square root. Any 
existing fractional part of the argument is taken into account, 
but otherwise the scale factor is ignored. 

! Interprets the rest of the line as an Altos UNIX System V com- 
mand. 

c All values on the stack are popped. 

i The top value on the stack is popped and used as the number 
radix for further input. 

I Pushes the input base on the top of the stack. 

o The top value on the stack is popped and used as the number 

radix for further output. 

O Pushes the output base on the top of the stack. 

k The top of the stack is popped, and that value is used as a non- 

negative scale factor; the appropriate number of places are 
printed on output, and maintained during multiplication, divi- 
sion, and exponentiation. The interaction of scale factor, input 
base, and output base will be reasonable if all are changed 
together. 

z The stack level is pushed onto the stack. 

Z Replaces the number on the top of the stack with its length. 

? A line of input is taken from the input source (usually the ter- 
minal) and executed. 

; : Used by be for array operations. 
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Example 



This example prints the first ten values of n!: 

[Ial+dsa*plal0>y]sy 

Osal 

lyx 

See Also 


bc(C) 

Diagnostics 




X is unimplemented 


The octal number x corresponds to a character 
that is not implemented as a command 


staek empty 


Not enough elements on the stack to do what 
was asked 


Out of spaee 


The free list is exhausted (too many digits) 


Out of headers 


Too many numbers being kept around 


Out of pushdown 


Too many items on the stack 


Nesting Depth 

Notes 


Too many levels of nested execution 



be is a preprocessor for dc, providing infix notation and a C-like syn- 
tax which implements functions and reasonable control structures for 
programs. For interactive use, he is preferred to de . 
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dd 

converts and copies a file 

Syntax 



dd [option=value] ... 

Description 



dd copies the specified input file to the specified output with possible 
conversions. The standard input and output are used by default. The 
input and output block size may be specified to take advantage of raw 
physical I/O. 

Option Value 

if=fde Input filename; standard input is default 

of=file Output filename; standard output is default 



ibs=« 



Input block size is n bytes (default is BSIZE block 
size) 



obs=n 



bs=« 



cbs=« 



Output block size (default is BSIZE block size) 

Sets both input and output block size, superseding ibs 
and obs. If no conversion is specified, it is particu- 
larly efficient since no in-core copy needs to be done 

Conversion buffer size 



skip=n 

seek=n 

count=n 

conv=ascii 

conv=ebcdic 

conv=ibm 

conv=lcase 



Skips n input records before starting copy 

Seeks n records from beginning of output file before 
copying 

Copies only n input records 

Converts EBCDIC to ASCII 

Converts ASCII to EBCDIC 

Slightly different map of ASCII to EBCDIC 

Maps alphabetic characters to lowercase 
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Option Value 

conv=ucase Maps alphabetic characters to uppercase 

conv=swab Swaps every pair of bytes 

conv=sync Pads every input record to ibs 

con v= 

Several comma- separated conversions 

Where sizes are specified, a number of bytes is expected. A number 
may end with k, b, or w to specify multiplication by 1024, 512, or 2 
respectively; a pair of numbers may be separated by x to indicate a 
product. 

cbs is used only if ascii or ebcdic conversion is specified. In the 
former case cbs characters are placed into the conversion buffer, con- 
verted to ASCII, and trailing blanks trimmed and newline added before 
sending the line to the output. In the latter case ASCII characters are 
read into the conversion buffer, converted to EBCDIC, and blanks 
added to make up an output record of size cbs . 

After completion, dd reports the number of whole and partial input 
and output blocks. 

Examples 

This command reads an EBCDIC tape, blocked ten 80-byte EBCDIC 
card images per record, into the ASCII file out file : 

dd if=/dev/rmtO of=outfile ibs=800 cbs=80 conv=ascii,lcase 

Note the use of raw magtape, dd is especially suited to I/O on raw 
physical devices because it allows reading and writing in arbitrary 
record sizes. 

See Also 

copy(C), cp(C), tar(C) 

Diagnostics 



/f/7 records in(out) Numbers of full and partial records 

read(written) 
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The ASCII/EBCDIC conversion tables are taken from the 256- 
character standard in the CACM Nov, 1968. The ibm conversion cor- 
responds better to certain IBM print train conventions. There is no 
universal solution. 

Newlines are inserted only on conversion to ASCII; padding is done 
only on conversion to EBCDIC. 

When using dd with a raw device, specify the block size as a multiple 
of 512-byte blocks. For example, to use a 9K block size, enter: 

dd if=file of=/dev/rfdO bs=18b 

You could also enter: 

dd if=file of=/dev/rfdO bs=9K 

Standards Conformance 



dd is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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devnm 

identifies device name 

Syntax 

/etc/devnm [ names ] 

Description 

devnm identifies the special file associated with the mounted file sys- 
tem where the argument name resides. 

This command is most commonly used by the /etc/rc2 scripts to con- 
struct a mount table entry for the root device. 

Exampies 

Be sure to type full pathnames in this example: 

/etc/devnm /usr 

If /dev/hdb is mounted on /usr, this produces: 
hdb /usr 

Files 

/dev/* Device names 
/etc/rc2 Startup commands 

See Also 



setmnt(ADM) 

Standards Conformance 



devnm is conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 
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df 



report number of free disk blocks 

Syntax 



df t -t 1 1 -f ][ -V J [ filesystems ] 

Description 



df prints out the number of free blocks and free inodes available for 
on-line filesystems by examining the counts kept in the super-blocks; 
filesystems may be specified by device name (e.g., /dev/root). If the 
filesystems argument is unspecified, the free space on all of the 
mounted filesystems is sent to the standard output. The list of 
mounted filesystems is given in /etc/mnttab. 

Options include: 

-t Causes total allocated block figures to be reported as well as 
number of free blocks. 

-f Reports only an actual count of the blocks in the free list (free 
inodes are not reported). With this option, df reports on raw de- 
vices. 

-V Reports the percent of blocks used as well as the number of 
blocks used and free. 

The -V option can not be used with other options. 

Files 



/dev/* 

/etc/mnttab 

See Also 



mount(ADM), fsck(ADM), mnttab(F) 

Notes 



See Notes under mown/ (ADM). 
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This utility reports sizes in 512 byte blocks, df v^\\\ report 2 blocks 
less free space, rather than 1 block, since the file uses one system 
block of 1024 bytes. 

The directory /etc/fscmd.d/ryP^ contains programs for each filesys- 
tem type, ^^invokes the appropriate binary. 

Authorization 



The behavior of this utility is affected by assignment of the querys- 
pace authorization, which is usually reserved for system administra- 
tors. Refer to the “Using a Trusted System” chapter of the User's 
Guide for more details. 

Standards Conformance 



<^is conformant with: 

AT&TSVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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diff 

compares two text files 

Syntax 

diff[-befh]filel file2 

Description 



dijf tells what lines must be changed in two files to bring them into 
agreement. If filel or file! is a dash (-), the standard input is used. If 
filel or file! is a directory, dijf uses the file in that directory that has 
the same name as the file (file2 or filel respectively) it is compared to. 
For example: 

diff Itmp dog 

compares the file named dog that is in the Itmp directory, with the file 
dog in the current directory. The normal output contains lines of these 
forms: 

nl a nSM 
nl ,n2 d n3 
nl,n2 c n3,n4 

These lines resemble ed commands to convert Jilel into Jile2. The 
numbers after the letters pertain to Jile2 . In fact, by exchanging a for 
d and reading backward, one may ascertain equally how to convert 
jUe2 into filel . As in ed, identical pairs where nl =n2 or n3 = n4 are 
abbreviated as a single number. 

Following each of these lines come all the lines that are affected in the 
first file flagged by <, then all the lines that are affected in the second 
file flagged by >. 

The -b option causes trailing blanks (spaces and tabs) to be ignored 
and other strings of blanks to compare equal. 

The -e option produces a script of a, c and d commands for the editor 
ed, which will recreate Jile2 from filel . The -f option produces a simi- 
lar script, not useful with ed, in the opposite order. In connection with 
-e, the following shell procedure helps maintain multiple versions of a 
file: 



(shift; cat $*; echo "l,$p") 1 ed - $1 
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This works by performing a set of editing operations on an original 
ancestral file. This is done by combining the sequence of ed scripts 
given as all command line arguments except the first. These scripts 
are presumed to have been created with diff in the order given on the 
command line. The set of editing operations is then piped as an edit- 
ing script to ed where all editing operations are performed on the 
ancestral file given as the first argument on the command line. The 
final version of the file is then printed on the standard output. Only an 
ancestral file ($1) and a chain of version- to- version ed scripts 
($2, $3,...) made by diff mod be on hand. 

Except in rare circumstances, diff finds the smallest sufficient set of 
file differences. 

The -h option does a fast, less-rigorous job. It works only when 
changed stretches are short and well separated, but the files can be of 
unlimited length. The -e and -f options cannot be used with the -h 
option. 

Files 



/tmp/d????? 

/usr/lib/diffh (executable used when -h option is specified) 

See Also 



cmp(C), comm(C), ed(C) 

Diagnostics 



Exit status is 0 for no differences, 1 for some differences, 2 for errors. 

Notes 



Editing scripts produced under the -e or -f option do not always work 
correctly on lines consisting of a single period (.). 

Standards Conformance 



diff is conformant with: 

AT&TSVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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diffS 

compares three files 

Syntax 

difB [ -ex3 ] filel file2 file3 

Description 



diffS compares three versions of a file, and publishes disagreeing 
ranges of text flagged with these codes: 

==== All three files differ 

===1 Filel is different 

====2 File2 is different 

====3 Files is different 

The type of change suffered in converting a given range of a given file 
to some other range is indicated in one of these ways: 

f : nl a Text is to be appended after line number nl in 

file/, where/ = 1, 2, or 3. 

f:nl^n2c Text is to be changed in the range line nl to 

line n2. If nl = nl, the range may be abbrevi- 
ated io nl . 

The original contents of the range follows immediately after a c indi- 
cation. When the contents of two files are identical, the contents of 
the lower-numbered file is suppressed. 

Under the -e option, diffS publishes a script for the editor ed that will 
incorporate into filel all changes between file2 and fileS , i.e., the 
changes that normally would be flagged ===== and ====3. The -x 
option produces a script to incorporate changes flagged with “====”. 
Similarly, the -3 option produces a script to incorporate changes 
flagged with “====3”. The following command applies a resulting 
editing script to filel : 

(cat script; echo 'l,$p') I ed - filel 
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Files 

/tmp/d3* 

/usr/lib/diff3prog 

See Also 

diff(C) 

Notes 

The -e option does not work properly for lines consisting of a single 
period. 

The input file size limit is 64K bytes. 
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dircmp 

compares directories 

Syntax 

dircmp [ -d ] [ -s ] [ -wn ] dirl dir2 

Description 



dircmp examines dirl and dirl and generates tabulated information 
about the contents of the directories. Listings of files that are unique 
to each directory are generated in addition to a list that indicates 
whether the files common to both directories have the same contents. 

There are three options available: 

-d Performs a full diff on each pair of like-named files if the 

contents of the files are not identical. 

-s Suppresses output of identical filenames. 

•wn Changes the width of the output line to n characters. The 
default width is 72. 



See Also 



cmp(C), diff(C) 

Standards Conformance 



dircmp is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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dirname 

delivers directory part of pathname 

Syntax 

dirname string 

Description 



dirname delivers all but the last component of the pathname in string 
and prints the result on the standard output. If there is only one com- 
ponent in the pathname, only a “dot” is printed. It is normally used 
inside substitution marks ^ ) within shell procedures. 

The companion command basename deletes any prefix ending in a 
slash (/) and the sujfix (if present in string) from string, and prints the 
result on the standard output. 

Examples 



The following example sets the shell variable NAME to /usr/src/cmd: 
NAME=^ dirname /usr/src/cmd/cat.c^ 

This example prints /a/b/c on the standard output: 
dirname /a/b/c/d 

This example prints a “dot” on the standard output: 
dirname file.ext 

This example moves to the location of a file being searched for {lost- 
file): 

cd ‘find . -name lostfile -exec dirname { } ;‘ 

See Also 



basename(C), sh(C) 

Standards Conformance 



dirname is conformant with: 



March 15, 1989 



DIRNAME-1 









DIRNAME (C) 



DIRNAME (C) 



The X/Open Portability Guide II of January 1987. 
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disable 

turns off terminals and printers 

Syntax 



disable tty ... 

disable [-c][-r [reason]] printers 

Description 



For terminals, this program manipulates the /etc/conf/cf.d/init.base 
file and signals init to disallow logins on a particular terminal. For 
printers, disable stops print requests from being sent to the named 
printer. The following options can be used: 

-c Cancels any requests that are currently printing. 

-r[reason\ Associates a reason with disabling the printer. The rea- 

son applies to all printers listed up to the next -r option. 
If the -r option is not present or the -r option is given 
without a reason, then a default reason is used. Reason 
is reported by lpstat(C). 

Examples 



In this example, a printer named linepr is disabled because of a paper 
jam: 



disable -r"paper jam" linepr 



Files 



/dev/tty* 

/etc/conf/cf.d/init.base 

/usr/spool/lp/* 

See Also 



login(M), enable(C), inittab(F), getty(M), init(M), lp(C), Ipstat(C), 
uugetty(ADM) 
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Authorization 



The behavior of this utility is affected by assignment of the printer - 
stat authorization, which is usually reserved for system administra- 
tors. Refer to the “Using a Trusted System” chapter of the User's 
Guide for more details. 



March 1 5, 1 989 



DISABLE-2 



DISKCP (C) 



DISKCP(C) 



diskcp, diskcmp 

copies or compares floppy disks 

Syntax 



diskcp [ -f ] [ -d ] [ -s ] [ -48ds9 ] [ -96ds9 ] [ -96dsl5 ] [ -135ds9 ] [ -135dsl8 ] 
diskcmp [ -d ] [ -s ] ( -48ds9 ] [ -96ds9 ] [ -96dsl5 ] [ -13Sds9 ] [ -135dsl8 ] 



Description 



diskcp is used to make an image (exact copy) of a source floppy disk 
on a target floppy disk. On machines with one floppy drive diskcp 
temporarily transfers the image to the hard disk until a “target” 
floppy is inserted into the floppy drive. On machines with two floppy 
drives diskcp immediately places the image of the source floppy 
directly on the target floppy. 

diskcmp functions similarly to diskcp . It compares the contents of one 
floppy disk with the contents of a second floppy disk using the cmp 
utility. 

The options are: 

-f Format the target floppy disk before the image is copied {diskcp 
only). 

-d The computer has dual floppy drives, diskcp copies the image 
directly onto the target floppy. 

-s Uses sum{C) to compare the contents of the source and target 
floppies; gives an error message if the two do not match. 

-48ds9 

This setting is for low density 48tpi floppies. It is the default set- 
ting. 

-96ds9 

This setting is for high density 96tpi floppies. 

-96dsl5 

This setting is for quad density 96tpi floppies. 

-135ds9 

This setting is for high density 135tpi 3.5 inch floppies. 
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-135dsl8 

This setting is for quad density 135tpi 3.5 inch floppies. 

When using the -96ds9 and -96dsl5 options of diskcp without the -f 
option, if the first target disk is unformatted, the program will note it, 
format it and make the copy. If another copy is requested and another 
unformatted target disk inserted, diskcp exits with a “System error.” 
Quit, format the floppy, and reinvoke diskcp to make another copy. 

Examples 



To make a copy of a floppy, place the source floppy in the drive and 
type: 

diskcp 

When diskcp is finished copying to the hard disk, it prompts you to 
insert the target floppy in the drive. If you specify the -f flag when you 
invoke diskcp , the program formats the target floppy. When the copy 
is finished, diskcp asks if you would like to make another copy of the 
same source disL If you enter ‘n’, it asks if you would like to copy 
another source disk. 

Specify the -d flag on the command line if you have two floppy drives: 
diskcp -d 



Notes 



If diskcp encounters a write error while copying the source image to 
the target disk, it formats the disk and tries to write the source image 
again. This happens most often when an unformatted floppy is used 
and the -f flag is not specified. 

Files 



/usr/bin/diskcp 

/usr/bin/diskcmp 

/tmp/disk???? 

See Also 



cmp(C), dd(C), format(C), sum(C) 

Value Added 



diskcmp and diskcp are extensions of AT&T System V provided by 
Altos UNIX System V. 
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dos: doscat, doscp, dosdir, dosfor- 
mat, dosmkdir, dosis, dosrm, 
dosrmdir 

access to and manipulation of DOS files and DOS 
filesystems 

Syntax 



doscat [ -r I -m ] file ... 
doscp [ -r I -m ] filel file2 
doscp [ -r I -m ] file ... directory 
dosdir directory ... 
dosformat [ -fqv ] drive 
dosis directory ... 
dosmkdir directory ... 
dosrm file ... 
dosrmdir directory ... 

Description 



The dos commands provide access to the files and directories on MS- 
DOS disks and on a DOS partition of a hard disk. Note that in order to 
use these commands on a DOS partition of a hard disk, the partition 
must be bootable, although not active. It is also possible to mount and 
access a DOS filesystem while operating from the Altos UNIX System 
V partition. 

The dos commands perform the following actions: 

doscat Copies one or more DOS files to the standard output. If 

-r is given, the files are copied without newline conver- 
sions. If -m is given, the files are copied with newline 
conversions (see “Conversions” below). 

doscp Copies files between a DOS disk and an Altos UNIX 

System V filesystem. If filel and file2 are given, is 
copied to file2 . If a directory is given, one or more files 
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are copied to that directory. If -r is given, the files are 
copied without newline conversions. If -m is given, the 
files are copied with newline conversions (see 
“Conversions” below). 

dosdir Lists DOS files in the standard DOS style directory for- 

mat. 

dosformat Creates a DOS 2.0 formatted diskette. The drive may 
be specified in either DOS drive convention, using the 
default file /etc/default/msdos, or using the Altos UNIX 
System V special file name, dosformat cannot be used 
to format a hard disk. The -f option suppresses the 
interactive feature. The -q (quiet) option is used to 
suppress information normally displayed during dosfor- 
mat . The -q option does not suppress the interactive 
feature. The -v option prompts the user for a volume 
label after the diskette has been formatted. The max- 
imum size of the volume label is 1 1 characters. 

dosls Lists DOS directories and files in an Altos UNIX Sys- 

tem V format (see ls{C)). 

dosrm Removes files from a DOS disk. 

dosmkdir Creates a directory on a DOS disk. 

dosrmdir Deletes directories from a DOS disk. 

The file and directory arguments for DOS files and directories have the 
form: 

device :name 

where device is an Altos UNIX System V pathname for the special de- 
vice file containing the DOS disk, and name is a pathname to a file or 
directory on the DOS disk. The two components are separated by a 
colon (:). For example, the argument: 

/dev/fdO:/src/file.asm 

specifies the DOS file, file.asm, in the directory, /src, on the disk in the 
device file /dev/fdO. Note that slashes (and not backslashes) are used 
as filename separators for DOS pathnames. Arguments without a de- 
vice: are assumed to be Altos UNIX System V files. 

For convenience, the user configurable default file, 
/etc/default/msdos, can define DOS drive names to be used in place of 
the special device file pathnames. It can contain lines with the follow- 
ing format: 
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A=/dev/fdO 

C=/dev/hdad 

D=/dev/hdbd 

The drive letter “A” may be used in place of special device file path- 
name /dev/fdO when referencing DOS files (see “Examples” below). 
The drive letter “C” or “D” refer to the DOS partition on the first or 
second hard disk. 

The commands operate on the following kinds of disks: 

DOS partitions on a hard disk 
5 1/4 inch DOS 
3 1/2 inch DOS 

8, 9, 15, or 18 sectors per track 
40 tracks per side 
1 or 2 sides 

DOS versions 1.0, 2.0 or 3.0 

Conversions 



In the case of doscp, certain conversions are performed when copying 
an Altos UNIX System V file. Filenames with a basename longer than 
eight characters are truncated. Filename extensions (the part of the 
name following separating period) longer than three characters are 
truncated. For example, the file 123456789.12345 becomes 
12345678.123. A message informs the user that the name has been 
changed and the altered name is displayed. Filenames containing ille- 
gal DOS characters are stripped when writing to the MS-DOS format. 
A message informs the user that characters have been removed and 
displays the name as written. 

All DOS text files use a carriage-retum/linefeed combination, CR-LF , 
to indicate a newline. Altos UNIX System V files use a single newline 
LF character. When the doscat and doscp commands transfer DOS 
text files to the Altos UNIX System V filesystem, they automatically 
strip the CR. When text files are transferred to DOS , the commands 
insert a CR before each LF character. 

Under some circumstances the automatic newline conversions do not 
occur. The -m option may be used to ensure the newline conversion. 
The -r option can be used to override the automatic conversion and 
force the command to perform a true byte copy regardless of file type 

Examples 



doscat /dev/fdO:/docs/memo.txt 

doscat /tmp/fl /tmp/f2 /dev/fdO:/src/file.asm 
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dosdir /dev/fdO:/src 
dosdir A:/src A:/dev 

doscp /tmp/my file.txt /dev/fdO:/docs/memo.txt 
doscp /tmp/fl /tmp/f2 /dev/fdO:/mydir 
dosformat /dev/fdO 

dosls /dev/fdO:/src 
dosls B: 

dosmkdir /dev/fdO:/usr/docs 

dosrm /dev/fdO:/docs/memo.txt 
dosrm A:/docs/memol.txt 

dosrmdir /dev/fdO:/usr/docs 

Accessing DOS Filesystems From the UNIX Parti- 



The ability to mount DOS filesystems is an extension of the DOS utili- 
ties documented here. 

There are several limitations with the DOS directory structure which 
makes this a difficult task. These limitations are due to insufficient in- 
formation when compared to the Altos UNIX System V filesystem. 

The DOS directory structure contains the following information: 

• Filename: up to 8 characters with 3 character extension 
(foo.bat) 

• File Attribute: read-only/read-write, hidden/visible file, 

system/normal file. Volume name/normal file name, 
subdirectory/normal file, archive/modified bit 

• Time of last modification 

• Date of last modification 

• Starting point (reference through FAT) 

• File size in bytes 

Using this information, it is converted to an actual UNIX inode. There 
are some Altos UNIX System V provisions that cannot be carried over, 
because the filesystem must remain sane under DOS. 

• Any date in the UNIX inode table for the DOS filesystem is the 
same as the modification date (crime = arime = mtime). 

• The only types of nodes allowed in the DOS filesystem are 
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directories and normal files. Pipes, semaphores, and special de- 
vice files do not exist because they do not have a counterpart 
under DOS. 

• The permissions are 0777 for readable/writable files and 0555 
for read only files. If a user can access the filesystem, the user 
will be limited by the permissions available under the DOS 
directory structure. This permission is read-only or read write. 
When creating a file, the creator’s umask/mode is examined. 
The creation mode is based on the owner write bit. 

• The gid/uid for all files on the DOS filesystem is the same as 
the mountpoint. The mount point will maintain the necessary 
security. If a user can get into the mountpoint, then the user has 
the same access as the owner. 

• There is only one link for each file under the DOS filesystem. 

and are a special case and are not links. 

• On every change of the modification time (which on an Altos 
UNIX System V system would change atime, ctime, mtime) the 
DOS archive bit is set. 

• Following DOS filesystem requirements, all blocks previous to 
a written block are allocated before the original block is writ- 
ten. This differs from Altos UNIX System V systems where the 
program may seek out beyond the end of a file and write a 
block. Altos UNIX System V systems do not necessarily write 
blocks that have been skipped over. 

• If a program does not use the directory(S) system calls, but 
opens the directory in the DOS filesystem as a file, the program 
should see the DOS directory structure as it really exists. By 
using the directory(S) system calls, the filesystem switch code 
will put together an Altos UNIX System V style directory entry. 

• File contents are not mapped from the DOS filesystem. The file 
appears exactly as it is under DOS. For example, \r\n combina- 
tions are left as \r\n and not mapped to just \n. The file and 
directory names are mapped to uppercase. 

DOS File Conversion 



The Utilities xtod(C) and dtox{C) can be used to convert the EOL 
sequences used to and from DOS, respectively. 
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/etc/default/msdos 

/dev/fd* 

/dev/hd* 

See Also 



Default information 
Floppy disk devices 
Hard disk devices 



assign(C), dtype(C), mkfs(ADM), dtox(C), xtod(C), and “Using 
DOS” in the System Administrator's Guide 

Notes 



Using the DOS utilities, is not possible to refer to DOS directories with 
wild card specifications. The programs mentioned above cooperate 
among themselves so no two programs will access the same DOS disk. 
Only one process will access a given DOS disk at any time, while 
other processes wait. If a process has to wait too long, it displays the 
error message, “can’t seize a device,” and exits with an exit code of 
1 . 

You cannot use the dosformat command to format device A: because 
it is aliased to /dev/install, which cannot be formatted. Use /dev/rfdO/ 
instead. 

The following hard disk devices: 

/dev/hdad 

/dev/rhdad 

/dev/hdbd 

/dev/rhdbd 

are similar to /dev/hdaa in that the disk driver determines which parti- 
tion is the DOS partition and uses that as hd?d. This means that soft- 
ware using the DOS partition does not need to know which partition is 
DOS. 

The Development System supports the creation of DOS executable 
files, using cc (CP). Refer to the C Usefs Guide and C Library Guide 
for more information on using your Altos UNIX System V system to 
create programs suitable for DOS systems. 

All of the DOS utilities leave temporary files in Itmp. These files are 
automatically removed when the system is rebooted. They can also be 
manually removed. 

You must have DOS 3.3 or earlier. Extended DOS partitions are not 
supported. 
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Value Added 



doscat, doscpy dosdir, dosformat, dosls, dosmkdir, dosrm and dosrmdir 
are extensions of AT&T System V provided by Altos UNIX System V. 
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dtox 

change file format from MS-DOS to UNIX 
Syntax 

dtox filename > outputfile 

Description 



The dtox command converts a file from MS-DOS format to Altos UNIX 
System V format. MS-DOS files terminate a line of text with a carriage 
return and a linefeed, while Altos UNIX System V files terminate a 
line with a linefeed only. Also MS-DOS places a (CTL)z at the end of a 
file, while Altos UNIX System V systems do not. Some programs and 
utilities are sensitive to this difference and some are not. If a text or 
data file is not being interpreted correctly, then use the dtox and xtod 
conversion utilities. The dtox command strips the extra carriage 
return from the end of each line and strips the <CTL)z from the end of 
the file. This utility is not required for binary object files. 

If no filename is specified on the command line, dtox takes input from 
standard input. Output of the utility goes to standard output. 

See Also 



xtod(C) 

Value Added 



dtox is an extension of AT&T System V provided by Altos UNIX Sys- 
tem V. 
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dtype 

determines disk type 

Syntax 

dtype [-s] device ... 

Description 



dtype determines type of disk, prints pertinent information on the stan- 
dard output unless the silent (-s) option is selected, and exits with a 
corresponding code (see below). When more than one argument is 
given, the exit code corresponds to the last argument. 



Disk 


Exit 


Message 




Code 


(optional) 


Misc. 


60 


error (specified) 




61 


empty or unrecognized data 


Storage 


70 


backup format, volume n 




71 


tar format[, extent e of n] 




72 


cpio format 




73 


cpio character (-c) format 


MS-DOS 


80 


DOS 1.x, 8 sec/track, single sided 




81 


DOS 1.x, 8 sec/track, dual sided 




90 


DOS 2.x, 8 sec/track, single sided 




91 


DOS 2.x, 8 sec/track, dual sided 




92 


DOS 2.x, 9 sec/track, single sided 




93 


DOS 2.x, 9 sec/track, dual sided 




94 


DOS 2.x, fixed disk 




no 


DOS 3.x, 9 sec/track, dual sided 


XENIX 


120 


XENIX 2.x filesystem [needs cleaning] 




130 


XENIX 3.x or later filesystem [needs cleaning] 


UNIX 


140 


UNIX IK filesystem [needs cleaning] 



Notes 



word’Swapped refers to byte ordering of long words in relation to the 
host system. 

XENIX filesystems and backup and cpio binary formats may not be 
recognized if created on a foreign system. This is due to such system 
differences as byte and word swapping and structure alignment. 

This utility only works reliably for floppy diskettes. 
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dtype is an extension of AT&T System V provided by Altos UNIX 
System V. 
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du 

summarizes disk usage 

Syntax 

du [ -afrsu ] [ names ] 

Description 



du gives the number of blocks contained in all files and directories 
recursively within each directory and file specified by the names 
argument. The block count includes the indirect blocks of the file. If 
names is missing, the current directory is used. 

-s causes only the grand total (for each of the specified names) to be 
given, -a causes an entry to be generated for each file. Absence of 
either causes an entry to be generated for each directory only. 

The -f option causes du to display the usage of files in the current file 
system only. Directories containing mounted file systems will be 
ignored. The -u option causes du to ignore files that have more than 
one link. 

du is normally silent about directories that cannot be read, files that 
cannot be opened, etc. The -r option will cause du to generate mes- 
sages in such instances. 

A file with two or more links is only counted once. 

Notes 



If the -a option is not used, nondirectories given as arguments are not 
listed. 

If there are too many distinct linked files, du will count the excess 
files more than once. 

Files with holes in them will get an incorrect block count. 

This utility reports sizes in 512 byte blocks, du interprets 1 block 
from a 1024 byte block system as 2 of its own 512 byte blocks. Thus a 
500 byte file is interpreted as 2 blocks rather than 1 . 
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Standards Conformance 



du is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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echo 

echo 

Syntax 



echo [-n] [ arg ] ... 

Description 



The echo command writes its arguments separated by blanks and ter- 
minated by a new-line on the standard output. The -n option prints a 
line without the new-line; same as using the \c escape sequence. 

echo also understands C-like escape conventions; beware of conflicts 
with the shell’s use of \: 

\b backspace 

\c print line without new-line 
\f form-feed 
\n new-line 
\r carriage return 
\t tab 

\v vertical tab 
W backslash 

\n The 8-bit character whose ASCII code is a 1, 2 or 3-digit octal 
number. In all cases, n must start with a zero. For example: 



echo 


"\07 " 


- Echoes Ctrl-G. 


echo 


"N007" 


- Also echoes Ctrl-G. 


echo 


"\065 " 


- Echoes the number “5 


echo 


"\0101 " 


- Echoes the letter “A”. 



The echo command is useful for producing diagnostics in com- 
mand files and for sending known data into a pipe. 

See Also 



sh(C) 
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Notes 



When representing an 8-bit character by using the escape conven- 
tion \0n, the n must always be preceded by the digit zero (0). 

For example, typing: echo 'WARNING :\07' will print the phrase 
WARNING: and sound the “bell” on your terminal. The use of 
single (or double) quotes (or two backslashes) is required to protect 
the “\” that precedes the “07”. 

For the octal equivalents of each character, see ascii {M). 
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ed, red 

invokes the text editor 

Syntax 



ed [ - ] [ -p string ] [ file ] 
red [ file ] 

Description 



ed is the standard text editor. If the file argument is given, ed simu- 
lates an e command (see below) on the named file; that is to say, the 
file is read into ed's buffer so that it can be edited, ed operates on a 
copy of the file it is editing; changes made to the copy have no effect 
on the file until a w (write) command is given. The copy of the text 
being edited resides in a temporary file called the buffer. There is 
only one buffer. 

red is a restricted version of ed(C). It will only allow editing of files 
in the current directory. It prohibits executing sh(C) commands via 
the ! command, red displays an error message on any attempt to 
bypass these restrictions. 

In general, red does not allow commands like 

!date 



or 

!sh 

Furthermore, red will not allow pathnames in its command line. For 
example, the command: 

red /etc/passwd 

when the current directory is not /etc causes an error. 

Options 



The options to ed are: 

Suppresses the printing of character counts by the e, r, and w 
commands, of diagnostics from e and q commands, and the ! 
prompt after a \shell command. 
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-p Allows the user to specify a prompt string. 

ed supports formatting capability. After including a format specifica- 
tion as the first line of file and invoking ed with your terminal in stty 
-tabs or stty tab3 mode (see sttyiC)), the specified tab stops will auto- 
matically be used when scanning file. For example, if the first line of 
a file contained: 

<:t5,10,15 s72:> 

tab stops would be set at columns 5, 10, and 15, and a maximum line 
length of 72 would be imposed. NOTE: While inputing text, tab char- 
acters are expanded to every eighth column as the default. 

Commands to ed have a simple and regular structure: zero, one, or two 
addresses followed by a single-character command, possibly followed 
by parameters to that command. These addresses specify one or more 
lines in the buffer. Every command that requires addresses has default 
addresses, so that the addresses can very often be omitted. 

In general, only one command may appear on a line. Certain com- 
mands allow the input of text. This text is placed in the appropriate 
place in the buffer. While ed is accepting text, it is said to be in input 
mode. In this mode, no commands are recognized; all input is merely 
collected. Input mode is left by entering a period (.) alone at the 
beginning of a line. 

ed supports a limited form of regular expression notation; regular 
expressions are used in addresses to specify lines and in some com- 
mands (e.g., s) to specify portions of a line that are to be substituted. 
A regular expression specifies a set of character strings. A member of 
this set of strings is said to be matched by the regular expression. The 
regular expressions allowed by ed are constructed as follows: 

The following one-character regular expressions match a single char- 
acter: 

1.1 An ordinary character {not one of those discussed in 1.2 below) 
is a one-character regular expression that matches itself. 

1.2 A backslash (\) followed by any special character is a one- 
character regular expression that matches the special character 
itself. The special characters are: 

a. ., *, [, and \ (dot, star, left square bracket, and backslash, 
respectively), which are otherwise special, except when they 
appear within square brackets ([]); see 1.4 below). 

b. (caret), which is special at the beginning of an entire regu- 
lar expression (see 3.1 and 3.2 below), or when it immedi- 
ately follows the left of a pair of square brackets ([]) (see 
1.4 below). 
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c. $ (dollar sign), which is special at the end of an entire regu- 
lar expression (see 3.2 below). 

d. The character used to bound (i.e., delimit) an entire regular 
expression, which is special for that regular expression (for 
example, see how slash (/) is used in the g command below). 

1.3 A period (.) is a one-character regular expression that matches 
any character except newline. 

1.4 A nonempty string of chtiracters enclosed in square brackets ([ ]) 
is a one-character regular expression that matches any one char- 
acter in that string. If, however, the first character of the string is 
a caret (^"), the one-character regular expression matches any 
character except newline and the remaining characters in the 
string. The star (*) also has this special meaning only if it occurs 
first in the string. The dash (-) may be used to indicate a range of 
consecutive ASCII characters; for example, [0-9] is equivalent to 
[0123456789]. The dash (-) loses this special meaning if it 
occurs first (after an initial caret (^), if any) or last in the string. 
The right square bracket (]) does not terminate such a string 
when it is the first character within it (after an initial caret ('"), if 
any); e.g., []a-f] matches either a right square bracket (]) or one 
of the letters “a” through “f ’ inclusive. Dot, star, left bracket, 
and the backslash lose their special meaning within such a string 
of characters. 

Ranges of characters (characters separated by - ) are treated according 
to the current locale’s collation sequence (see locale QA)). Therefore, 
if the collation sequence in use is A, a, B, b, C, c, then the expression 
[a-d] is equivalent to the expression [aBbCcDd]. 

To specify a collation item within a class, the item must be enclosed 
between [. and .] . Two character to one collation item mappings must 
be specified this way. For example, if the current collation rules 
specify that the characters “Ch” map to one character for collation 
purposes (as in Spanish), then this collation item would be specified as 
[.Ch.] . 

To specify a group of collation items, which are classified as equal 
unless all other collation items in the string also match, in which case 
a secondary “weight” becomes significant, a single member of that 
group must be enclosed between [= and =] . For example, if the char- 
acters A and a are in the same group then the class expressions 
[[=a=]b], [[=A=]b] and [Aab] are all equivalent. 

The ctype classes can also be specified within regular expressions. 
These are enclosed between [: and :] . The possible ctype classes are: 
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[:alpha:] Matches 

[:upper:] Matches 

[:lower:] Matches 

[•.digit:] Matches 

[:alnum:] Matches 

[:space:j Matches 

[:print:] Matches 

[:punct:] Matches 

[•.graph:] Matches 

[:cntrl:] Matches 



alphabetic characters 
upper case characters 
lower case characters 
digits 

alphanumeric characters 
white space 
printable characters 
punctuation marks 
graphical characters 
control characters 



The following rules may be used to construct regular expressions from 
one-character regular expressions: 

2.1 

A one-character regular expression followed by a star (*) is a regu- 
lar expression that matches zero or more occurrences of the one- 
character regular expression. If there is any choice, the longest 
leftmost string that permits a match is chosen. 



2.2 

A one-character regular expression followed by or 

\{m,n\} is a regular expression that matches a range of occurren- 
ces of the one-character regular expression. The values of m and n 
must be nonnegative integers less than 255; \{m\} matches exactly 
m occurrences; matches at least m occurrences; \{w,n\} 

matches any number of occurrences between m and n, inclusive. 
Whenever a choice exists, the regular expression matches as many 
occurrences as possible. 



2.3 

The concatenation of regular expressions is a regular expression 
that matches the concatenation of the strings matched by each 
component of the regular expression. 



2.4 

A regular expression enclosed between the character sequences \( 
and \) is a regular expression that matches whatever the unadorned 
regular expression matches. See 2.6 below for a discussion of why 
this is useful. 



2.5 

The expression \n matches the same string of characters as was 
matched by an expression enclosed between \( and \) earlier in the 
same regular expression. Here is a digit; the subexpression 
specified is that beginning with the n-th occurrence of \( counting 
from the left. For example, the expression ^\(.*\)\1$ matches a 
line consisting of two repeated appearances of the same string. 

Finally, an entire regular expression may be constrained to match 
only an initial segment or final segment of a line (or both): 
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3.1 A caret ('') at the beginning of an entire regular expression con- 
strains that regular expression to match an initial segment of a 
line. 

3.2 A dollar sign ($) at the end of an entire regular expression con- 
strains that regular expression to match a final segment of a line. 
The construction ^entire regular expression % constrains the 
entire regular expression to match the entire line. 

The null regular expression (e.g., //) is equivalent to the last regular 
expression encountered. 

To understand addressing in ed , it is necessary to know that there is a 
current line at all times. Generally speaking, the current line is the last 
line affected by a command; the exact effect on the current line is dis- 
cussed under the description of each command. Addresses are con- 
structed as follows: 

1 . The character . addresses the current line. 

2. The character $ addresses the last line of the buffer. 

3. A decimal number n addresses the «-th line of the buffer. 

4. 'x addresses the line marked with the mark name character jc, 
which must be a lowercase letter. Lines are marked with the k 
command described below. 

5. A regular expression enclosed by slashes (/) addresses the first 
line found by searching forward from the line following the 
current line toward the end of the buffer and stopping at the first 
line containing a string matching the regular expression. If 
necessary, the search wraps around to the beginning of the buffer 
and continues up to and including the current line, so that the 
entire buffer is searched. 

6. A regular expression enclosed in question marks (?) addresses 
the first line found by searching backward from the line preced- 
ing the current line toward the beginning of the buffer and stop- 
ping at the first line containing a string matching the regular 
expression. If necessary, the search wraps around to the end of 
the buffer and continues up to and including the current line. See 
also the last paragraph before Files below. 

7. An address followed by a plus sign (+) or a minus sign (-) fol- 
lowed by a decimal number specifies that address plus or minus 
the indicated number of lines. The plus sign may be omitted. 

8. If an address begins with + or -, the addition or subtraction is 
taken with respect to the current line; e.g, -5 is understood to 
mean .-5. 
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9. If an address ends with + or then 1 is added to or subtracted 
from the address, respectively. As a consequence of this rule and 
of rule 8 immediately above, the address - refers to the line 
preceding the current line. (To maintain compatibility with ear- 
lier versions of the editor, the character in addresses is entirely 
equivalent to -.) Moreover, trailing + and - characters have a 
cumulative effect, so -- refers to the current line less 2. 

10. For convenience, a comma (,) stands for the address pair 1,$, 
while a semicolon (;) stands for the pair ,,$. 

Commands may require zero, one, or two addresses. Commands that 
require no addresses regard the presence of an address as an error. 
Commands that accept one or two addresses assume default addresses 
when an insufficient number of addresses is given; if more addresses 
are given than such a command requires, the last address(es) are used. 

Typically, addresses are separated from each other by a comma (,)• 
They may also be separated by a semicolon (;). In the latter case, the 
current line (•) is set to the first address, and only then is the second 
address calculated. This feature can be used to determine the starting 
line for forward and backward searches (see rules 5 and 6 above). The 
second address of any two-address sequence must correspond to a line 
that follows, in the buffer, the line corresponding to the first address. 

In the following list of ed commands, the default addresses are shown 
in parentheses. The parentheses are not part of the address. 

It is generally illegal for more than one command to appear on a line. 
However, any command (except e,f, r, or w) may be suffixed by p or 
by 1, in which case the current line is either printed or listed, respec- 
tively, as discussed below under the p and / commands. 

(.)a 

<text> 

The append command reads the given text and appends it after the 
addressed line; dot is left at the address of the last inserted line, or, 
if there were no inserted lines, at the addressed line. Address 0 is 
legal for this command; it causes the “appended” text to be 
placed at the beginning of the buffer. 

(.)c 

<text> 

The change command deletes the addressed lines, then accepts 
input text that replaces these lines; dot is left at the address of the 
last line input, or, if there were none, at the first line that was not 
deleted. 

The c?elete command deletes the addressed lines from the buffer. 
The line after the last line deleted becomes the current line; if the 
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lines deleted were originally at the end of the buffer, the new last 
line becomes the current line. 

efile 

The ^dit command causes the entire contents of the buffer to be 
deleted, and then the named file to be read in; dot is set to the last 
line of the buffer. If no filename is given, the currently remem- 
bered filename, if any, is used (see the / command). The number 
of characters read is typed, file is remembered for possible use as 
a default filename in subsequent e, r, and w commands. If file 
begins with an exclamation (!), the rest of the line is taken to be a 
shell command. The output of this command is read for the e and r 
commands. For the w command, the file is used as the standard 
input for the specified command. Such a shell command is not 
remembered as the current filename. 

E file 

The Edit command is like e, except the editor does not check to 
see if any changes have been made to the buffer since the last w 
command. 

ffile 

If file is given, the /ilename command changes the currently 
remembered filename to file; otherwise, it prints the currently 
remembered filename. 

( 1 , $ )g! regular-expression Icommand list 

In the global command, the first step is to mark every line that 
matches the given regular expression. Then, for every such line, 
the given command list is executed with . initially set to that line. 
A single command or the first of a list of commands appears on the 
same line as the global command. All lines of a multiline list 
except the last line must be ended with a \; ^2, /, and c commands 
and associated input are permitted; the . terminating input mode 
may be omitted if it would be the last line of the command list. An 
empty command list is equivalent to the p command. The 
and V commands are not permitted in the command list. See also 
Notes and the last paragraph before Files below. 

( 1 , $ )Glregular~expression / 

In the interactive Global command, the first step is to mark every 
line that matches the given regular expression. Then, for every 
such line, that line is printed, dot (.) is changed to that line, and 
any one command (other than one of the a, c, i, g, G, v, and V 
commands) may be input and is executed. After the execution of 
that command, the next marked line is printed, and so on. A new- 
line acts as a null command. An ampersand (&) causes the re- 
execution of the most recent command executed within the current 
invocation of G. Note that the commands input as part of the exe- 
cution of the G command may address and affect any lines in the 
buffer. The G command can be terminated by entering an INTER- 
RUPT (pressing the DEL key). 
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h 

The /zelp command gives a short error message that explains the 
reason for the most recent ? diagnostic. 

H 

The //elp command causes ed to enter a mode in which error mes- 
sages are printed for all subsequent ? diagnostics. It will also 
explain the previous diagnostic if there was one. The H command 
alternately turns this mode on and off. It is initially off. 

(.)i 

<text> 

The insert command inserts the given text before the addressed 
line; dot is left at the address of the last inserted line, or if there 
were no inserted lines, at the addressed line. This command differs 
from the a command only in the placement of the input text. 
Address 0 is not legal for this command. 

(•5« + l)j 

The yoin command joins contiguous lines by removing the appro- 
priate newline characters. If only one address is given, this com- 
mand does nothing. 

(.)kx 

The mar/: command marks the addressed line with name x, which 
must be a lowercase letter. The address x then addresses this line. 
Dot is unchanged. 

(.,.)! 

The list command prints the addressed lines in an unambiguous 
way: a few nonprinting characters (e.g., tab, backspace) are 
represented by mnemonic overstrikes, all other nonprinting charac- 
ters are printed in octal, and long lines are folded. An I command 
may be appended to any command other than ^,/, r, or w. 

The move command repositions the addressed line(s) after the line 
addressed by a. Address 0 is legal for a and causes the addressed 
line(s) to be moved to the beginning of the file. It is an error if 
address a falls within the range of moved lines. Dot is left at the 
last line moved. 

(.,.)n 

The number command prints the addressed lines, preceding each 
line by its line number and a tab character. Dot is left at the last 
line printed. The n command may be appended to any command 
other than r, or w. 

(.,.)P 

The print command prints the addressed lines. Dot is left at the 
last line printed. The p command may be appended to any 
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command other than £?,/, r, or w; for example, dp deletes the 
current line and prints the new current line. 



The editor will prompt with a * for all subsequent commands. The 
P command alternately turns this mode on and off. It is initially off. 



The ^uit command causes ed to exit. No automatic write of a file 
is done. 



Q 

The editor exits without checking if changes have been made in 
the buffer since the last w command. 

($)rftle 

The read command reads in the given file after the addressed line. 
If no filename is given, the currently remembered filename, if any, 
is used (see e and / commands). The currently remembered 
filename is not changed unless JUe is the very first filename men- 
tioned since ed was invoked. Address 0 is legal for r and causes 
the file to be read at the beginning of the buffer. If the read is suc- 
cessful, the number of characters read is typed. Dot is set to the 
address of the last line read in. If file begins with !, the rest of the 
line is taken to be a shell command whose output is to be read. 
Such a shell command is not remembered as the current filename. 

( . , . )slregular-expression ! replacement I or 

( . , . )s! regular-expression ! replacement Ig or 

( . , . )slregular-expression ! replacement In «=1-512 

The .yubstitute command searches each addressed line for an oc- 
currence of the specified regukir expression. In each line in which 
a match is found, all nonoverlapped matched strings are replaced 
by replacement if the global replacement indicator g appears after 
the command. If the global indicator does not appear, only the first 
occurrence of the matched string is replaced. It is an error for the 
substitution to fail on all addressed lines. Any character other than 
space or newline may be used instead of / to delimit regular- 
expression and replacement . Dot is left at the address of the last 
line on which a substitution occurred. 

The n character represents any number between one and 512. This 
number indicates the instance of the pattern to be replaced on each 
addressed line. 

An ampersand (&) appearing in replacement is replaced by the 
string matching the regular-expression on the current line. The 
special meaning of the ampersand in this context may be 
suppressed by preceding it with a backslash. The characters \n, 
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h 

The /zelp command gives a short error message that explains the 
reason for the most recent ? diagnostic. 

H 

The //elp command causes ed to enter a mode in which error mes- 
sages are printed for all subsequent ? diagnostics. It will also 
explain the previous diagnostic if there was one. The H command 
alternately turns this mode on and off. It is initially off. 

(.)i 

<text> 

The insert command inserts the given text before the addressed 
line; dot is left at the address of the last inserted line, or if there 
were no inserted lines, at the addressed line. This command differs 
from the a command only in the placement of the input text. 
Address 0 is not legal for this command. 

( • 5 •+! )j 

The yoin command joins contiguous lines by removing the appro- 
priate newline characters. If only one address is given, this com- 
mand does nothing. 

(.)kx 

The mark command marks the addressed line with name x, which 
must be a lowercase letter. The address x then addresses this line. 
Dot is unchanged, 

(.,.)! 

The list command prints the addressed lines in an unambiguous 
way: a few nonprinting characters (e.g., tab, backspace) are 
represented by mnemonic overstrikes, all other nonprinting charac- 
ters are printed in octal, and long lines are folded. An / command 
may be appended to any command other than e,f, r, or w. 

( . , . )ma 

The move command repositions the addressed line(s) after the line 
addressed by a. Address 0 is legal for a and causes the addressed 
line(s) to be moved to the beginning of the file. It is an error if 
address a falls within the range of moved lines. Dot is left at the 
last line moved. 

,.)n 

The /lumber command prints the addressed lines, preceding each 
line by its line number and a tab character. Dot is left at the last 
line printed. The n command may be appended to any command 
other than e r, or w. 

(.,.)p 

The print command prints the addressed lines. Dot is left at the 
last line printed. The p command may be appended to any 
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command other than e,f, r, or w; for example, dp deletes the 
current line and prints the new current line. 



The editor will prompt with a * for all subsequent commands. The 
P command alternately turns this mode on and off. It is initially off. 



The quit command causes ed to exit. No automatic write of a file 
is done. 



Q 

The editor exits without checking if changes have been made in 
the buffer since the last w command. 

($)rftle 

The read command reads in the given file after the addressed line. 
If no filename is given, the currently remembered filename, if any, 
is used (see e and / commands). The currently remembered 
filename is not changed unless file is the very first filename men- 
tioned since ed was invoked. Address 0 is legal for r and causes 
the file to be read at the beginning of the buffer. If the read is suc- 
cessful, the number of characters read is typed. Dot is set to the 
address of the last line read in. If file begins with !, the rest of the 
line is taken to be a shell command whose output is to be read. 
Such a shell command is not remembered as the current filename. 

( . , . )slregular-expression ! replacement I or 

( . , . )sl regular- express ion ! replacement /g or 

( . , . )slregular-expression ! replacement In n=l-512 

The substitute command searches each addressed line for an oc- 
currence of the specified reguktr expression. In each line in which 
a match is found, all nonoverlapped matched strings are replaced 
by replacement if the global replacement indicator g appears after 
the command. If the global indicator does not appear, only the first 
occurrence of the matched string is replaced. It is an error for the 
substitution to fail on all addressed lines. Any character other than 
space or newline may be used instead of / to delimit regular- 
expression and replacement . Dot is left at the address of the last 
line on which a substitution occurred. 

The n character represents any number between one and 512. This 
number indicates the instance of the pattern to be replaced on each 
addressed line. 

An ampersand (&) appearing in replacement is replaced by the 
string matching the regular-expression on the current line. The 
special meaning of the ampersand in this context may be 
suppressed by preceding it with a backslash. The characters \n. 
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where n is a digit, are replaced by the text matched by the «-th reg- 
ular subexpression of the specified regular expression enclosed 
between \( and \). When nested parenthesized subexpressions are 
present, n is determined by counting occurrences of \( starting 
from the left. When the character % is the only character in 
replacement y the replacement used in the most recent substitute 
command is used as the replacement in the current substitute com- 
mand. The % loses its special meaning when it is in a replace- 
ment string of more than one character or when it is preceded by a 



A line may be split by substituting a newline character into it. The 
newline in the replacement must be escaped by preceding it with a 
\. Such a substitution cannot be done as part of a ^ or v command 
list. 

{.,.)ia 

This command acts just like the m command, except that a copy of 
the addressed lines is placed after address a (which may be 0). Dot 
is left at the address of the last line of the copy. 



u 

The wndo command nullifies the effect of the most recent com- 
mand that modified anything in the buffer, namely the most recent 
a, c, dy gy iyjy my Cy Sy ty V, G, Or V command. 

( 1 , $ )\! regular- expression Icomrnand list 

This command is the same as the global command g except that 
the command list is executed with dot initially set to every line 
that does not match the regular expression. 

( 1 , $ )\l regular- expression I 

This command is the same as the interactive global command G 
except that the lines that are marked during the first step are those 
that do not match the regular expression. 

The write command writes the addressed lines into the named file. 
If the file does not exist, it is created with mode 666 (readable and 
writeable by everyone), unless the umask setting (see sh(C)) dic- 
tates otherwise. The currently remembered filename is not 
changed unless file is the very first filename mentioned since ed 
was invoked. If no filename is given, the currently remembered 
filename, if any, is used (see e and / commands), and dot remains. 
If the command is successful, the number of characters written is 
displayed. If file begins with an exclamation (!), the rest of the 
line is taken to be a shell command to which the addressed lines 
are supplied as the standard input. Such a shell command is not 
remembered as the current filename. 
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($)= 

The line number of the addressed line is typed. Dot is unchanged 
by this command. 

Ishell command 

The remainder of the line after the ! is sent to the UNIX shell 
{sh{C)) to be interpreted as a command. Within the text of that 
command, the unescaped character % is replaced with the remem- 
bered filename. If a ! appears as the first character of the shell 
command, it is replaced with the text of the previous shell com- 
mand. Thus, !! will repeat the last shell command. If any expan- 
sion is performed, the expanded line is echoed. Dot is unchanged. 

(.+ 1 ) 

An address alone on a line causes the addressed line to be printed. 
A RETURN alone on a line is equivalent to .+lp. This is useful for 
stepping forward through the editing buffer a line at a time. 

If an interrupt signal (ASCII DEL or BREAK) is sent, ed prints a ques- 
tion mark (?) and returns to its command level. 

ed has size limitations: 512 characters per line, 256 characters per 
global command list, 64 characters per filename, and 128K characters 
in the buffer. The limit on the number of lines depends on the amount 
of user memory. 

When reading a file, ed discards ASCII NUL characters and all charac- 
ters after the last newline. Files (e.g., a.out) that contain characters 
not in the ASCII set (bit 8 on) cannot be edited by ed. 

If the closing delimiter of a regular expression or of a replacement 
string (e.g., /) would be the last character before a newline, that delim- 
iter may be omitted, in which case the addressed line is printed. Thus, 
the following pairs of commands are equivalent: 

s/sl/s2 s/sl/s2/p 
g/sl g/sl/p 

?sl ?sl? 

Files 



/tmp/e# Temporary; # is the process number 
ed.hup Work is saved here if the terminal is hung up 

See Also 



coltbl(M), grep(C), locale(M), sed(C), sh(C), stty(C), regexp(S) 
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Diagnostics 



? Command errors 
? file An inaccessible file 

Use the /zelp and //elp commands for detailed explanations. 

If changes have been made in the buffer since the last w command that 
wrote the entire buffer, ed warns the user if an attempt is made to de- 
stroy ed's buffer via the e or q commands by printing ? and allowing 
you to continue editing. A second e or q command at this point will 
take effect. The dash (-) command-line option inhibits this feature. 

Notes 



An exclamation (!) command cannot be subject to a ^ or a v com- 
mand. 

The I command and the ! escape from the r, and w commands can- 
not be used if the the editor is invoked from a restricted shell (see 
sh(0). 

The sequence \n in a regular expression does not match any character. 
The / command mishandles DEL. 

Because 0 is an illegal address for the w command, it is not possible to 
create an empty file with ed. 

If the editor input is coming from a command file (i.e., ed file < ed- 
cmd-file), the editor will exit at the first failure of a command in the 
command file. 

Standards Conformance 



ed is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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enable 

turns on terminals and line printers 

Syntax 



enable tty ... 
enable printers 

Description 



For terminals this program manipulates the /etc/conf/init.base file and 
signals init to allow logins on a particular terminal. 

For line printers, enable activates the named printers and enables them 
to print requests taken by /p(C). Use lpstat(C) to find the status of the 
printers. 

Exampies 

A simple command to enable ttyOl follows: 
enable ttyOl 

Fiies 

/dev/tty* 

/etc/conf/init.base 

/usr/spool/lp/* 

See Also 



disable(C), getty(M), init(M), login(M), lp(C), Ipstat(C), inittab(F), 
uugetty(M) 

Authorization 



The behavior of this utility is affected by assignment of the printer- 
stat authorization, which is usually reserved for system administra- 
tors. Refer to the “Using a Trusted System” chapter of the User's 
Guide for more details. 
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env 

sets environment for command execution 

Syntax 

env [-] [ name=value ] ... [ command [args] ] 

Description 



env obtains the current environment , modifies it according to its argu- 
ments, then executes the command with the modified environment. 
Arguments of the form ncwie=value are merged into the inherited 
environment before the command is executed. The - flag causes the 
inherited environment to be ignored completely, so that the command 
is executed with exactly the environment specified by the arguments. 

If no command is specified, the environment is printed, one name- 
value pair per line. 

See Also 



sh(C), exec(S), profile(F), environ(M) 

Notes 



The old printenv command was replaced in and System V by the env 
command. The current printenv is a link to env. 

Standards Conformance 



env is conformant with: 

AT&TSVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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ex, edit 

invokes a text editor 

Syntax 



ex [ -s ] [ -V ] [ -t tag ] [ -r file ] [ -L ] [ -R ] [ -c command ] name ... 
edit [-r] [-x] [-C] name . . . 

Description 



ex is the root of the editors ex and vi. ex is a superset of ed, with the 
most notable extension being a display editing facility. Display based 
editing is the focus of vi. 

edit is a variant of the text editor ex recommended for new or casual 
users who wish to use a command-oriented editor. It operates pre- 
cisely as ex(C) with the following options automatically set: 



novice ON 

report ON 

showmode ON 

magic OFF 



These options can be turned on or off via the set command in ex(C). 

Refer to the v/(C) page for a complete description of the ex com- 
mands. 



Files 

/usrAib/ex3.7strings 

/usrAib/ex3 .Trecover 

/usr/lib/ex3 .Tpreserve 

/etc/termcap 

$HOME/.exrc 

/tmp/Exnnnnn 

/tmp/Rxnnnnn 



Error messages 

Recover command 

Preserve command 

Describes capabilities of terminals 

Editor startup file 

Editor temporary 

Named buffer temporary 
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/usr/preserve 

See Also 



Preservation directory 



awk(C), ctags(CP), ed(C), grep(C), sed(C), termcap(F), vi(C) 

Credit 



This Utility was developed at the University of California at Berkeley 
and is used with permission. 

Standards Conformance 



ex is conformant with: 

AT&TSVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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expr 

evaluates arguments as an expression 

Syntax 



expr arguments 

Description 



The arguments are taken as an expression. After evaluation, the result 
is written on the standard output. Terms of the expression must be 
separated by blanks. Characters special to the shell must be escaped. 
Note that zero is returned to indicate a zero value, rather than the null 
string. Strings containing blanks or other special characters should be 
quoted. Integer-valued arguments may be preceded by a unary minus 
sign. Internally, integers are treated as 32-bit, 2's complement num- 
bers. 

The operators and keywords are listed below. Expressions should be 
quoted, since many of the characters that have special meaning in the 
shell also have special meaning in expr. The list is in order of increas- 
ing precedence, with equal precedence operators grouped within 
braces ( { and }). 

expr I expr 

Returns the first expr if it is neither null nor 0, otherwise 
returns the second expr. 

expr & expr 

Returns the first expr if neither expr is null nor 0, otherwise 
returns 0. 

expr { =, >, >=, <, <=, != } expr 

Returns the result of an integer comparison if both arguments 
are integers, otherwise returns the result of a lexical com- 
parison, as defined by the locale. 

expr { +, - } expr 

Addition or subtraction of integer-valued arguments. 
expr {*,/,%} expr 

Multiplication, division, or remainder of the integer-valued 
arguments. 

expr : expr 

The matching operator : compares the first argument with the 
second argument which must be a regular expression; regular 
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expression syntax is the same as that of ed(C), except that all 
patterns are “anchored” (i.e., begin with a caret Q) and there- 
fore the caret is not a special character in that context. (Note 
that in the shell, the caret has the same meaning as the pipe 
symbol (I).) Normally the matching operator returns the num- 
ber of characters matched (zero on failure). Alternatively, the 
\(...\) pattern symbols can be used to return a portion of the 
first argument. 

Examples 



1. a=^expr $a + 1^ 

Adds 1 to the shell variable a. 

2. # For $a ending in "/file” 
expr $a : \*/\(.A)' 

Returns the last segment of a pathname (i.e., file). Watch out 
for the slash alone as an argument: expr will take it as the divi- 
sion operator (see Notes on the next page). 

3. expr $VAR : 

Returns the number of characters in $VAR. 

See Also 



coltbl(M), ed(C), locale(M), sh(C) 

Diagnostics 



As a side effect of expression evaluation, expr returns the following 
exit values: 

0 If the expression is neither null nor zero 

1 If the expression is null or zero 

2 For invalid expressions 

Other diagnostics include: 

syntax error For operator/operand errors, including unset vari- 

ables 

nonnumeric argument 

If arithmetic is attempted on a nonnumeric string 
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Notes 



After argument processing by the shell, expr cannot tell the difference 
between an operator and an operand except by the value. If $a is an 
equals sign (=), the command: 

expr $a = = 

looks like: 

expr = = = 

The arguments are passed to expr and will all be taken as the = opera- 
tor. The following permits comparing equals signs: 



expr X$a = X= 



Standards Conformance 



expr is conformant with: 

AT&TSVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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factor 

factor a number 

Syntax 

factor [ number ] 

Description 



factor is invoked without an argument, it waits for a number to 
be typed in. If you type in a positive number less than 2^^ (about 
7.2x10^^) it will factor the number and print its prime factors; each 
one is printed the proper number of times. Then it waits for another 
number. It exits if it encounters a zero or any non-numeric character. 

\i factor is invoked with an argument, it factors the number as above 
and then exits. 

The time it takes to factor a number, n, is proportional to fjn. It usu- 
ally takes longer to factor a prime or the square of a prime, than to fac- 
tor other numbers. 

Diagnostics 



factor returns an error message if the supplied input value is greater 
than 2^^ or is not an integer number. 
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false 

returns with a nonzero exit value 
Syntax 

false 

Description 



false does nothing except return with a nonzero exit value. true{C), 
false's counterpart, does nothing except return with a zero exit value. 
“False” is typically used in shell procedures such as: 

until false 
do 

command 

done 

See Aiso 



sh(C), true(C) 

Diagnostics 

false is any non-zero value. 

Standards Conformance 



false is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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file 

determines file type 

Syntax 

file [ -m 1 file ... 
file [ -m ] -f namesfile 

Description 



file performs a series of tests on each argument in an attempt to clas- 
sify it. If an argument appears to be ASCII, examines the first 512 
bytes and tries to guess its language. 

If the -f option is given, takes the list of filenames from namesfile. 
If the -m option is given, ///^? sets the access time for the examined file 
to the current time. Otherwise, the access time remains unchanged. 

Several object file formats are recognized. For a.out and x.out format 
object files, ///(? reports “separate’’ if the file was linked with cc -i, 
“pure” if the file was linked with cc -n, and “not stripped” if the 
file was not linked with cc -s or \f strip(C?) was not run. 

Credit 



This utility was developed at the University of California at Berkeley 
and is used with permission. 

Notes 



file makes errors; in particular it often mistakes command files for C 
programs. 

The file command can only distinguish English text. If an 8 bit char- 
acter (a character not in the English alphabet) is found, then the text 
will be defined as “8 bit text”. 

Standards Conformance 



file is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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find 

finds files 

Syntax 

find pathname-list expression 

Description 

The find command is used to find files matching a certain set of selec- 
tion criteria, find recursively descends the directory hierarchy for each 
pathname in the pathname-list (i.e., one or more pathnames) seeking 
files that match a Boolean expression written in the primaries given 
below. 

Expressions 

For each file encountered, find evaluates the specified expression, 
formed of one or more of the following primary expressions, which 
may evaluate as true or false. In the descriptions, the argument n is 
used as a decimal integer where +72 means more than n, -n means less 
than n and n means exactly n. 

-name file True if file matches the current file name. Normal 

shell argument syntax may be used if escaped 
(watch out for the left bracket ([), the question 
mark (?) and the star (*)). 

-perm onum True if the file permission flags exactly match 
oniim (see chmod(C)). If onum is prefixed by a 
minus sign, all other modes become significant 
(see mknod(S)), including the file type, setuid, set- 
gid, and sticky bits rather than just 
read/write/execute modes for owner/group/other. 

-typex True if the type of the file is x, where x is b for 

block special file, c for character special file, d for 
directory, p for named pipe (first-in- first-out), or f 
for regular file. 

-links n True if the file has n links. 

-inum num True if the file’s inode is num. This is useful for 

locating files with matching inodes. 
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-user uname 

-group gname 

-size n 

-atime n 
-mtime n 

-ctime n 

-exec and 

-ok and 

-cpio device 
-depth 

-print 

-newer file 
( expression ) 
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FIND (C) 

True if the file belongs to the user uname. If 
uname is numeric and does not appear as a login 
name in the /etc/pass wd file, it is taken as a user 
ID. 

True if the file belongs to the group gname. If 
gname is numeric and does not appear in the 
/etc/group file as a group name, it is taken as a 
group ID. 

True if the file is n blocks long (512 bytes per 
block). 

True if the file was last accessed n days ago. 

True if the data in the file was last modified n days 
ago. 

True if the file’s status was last changed (i.e. creat- 
ed or modified) n days ago. 

Executes shell command cmd. The end of cmd 
must be punctuated by an escaped semicolon. A 
command argument {} is replaced by the current 
path name. True if the executed cmd returns a 
zero value as exit status (most commands return a 
zero value on successful completion and a non- 
zero value if an error is encountered). 

Like -exec except that the generated command 
line is printed with a question mark first, and is 
executed only if the user responds by typing y. 

Writes the current file on device in cpioif) format 
(5120-byte records). Always true. 

Causes all entries in a directory to be acted upon 
before the directory itself. This can be useful 
when used with cpioiC) or the -cpio expression to 
transfer files located in directories without write 
permission. Always true. 

Causes the current path name to be printed. This 
option is used to create a list of all files matched 
by the previous primaries. Always true. 

True if the current file has been modified more 
recently than the argument file. 

True if the parenthesized expression is true. Usu- 
ally used with the -o operator (see below), 
parentheses are used for grouping. Parentheses are 
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special to the shell and must be escaped. 

The primaries may be combined using the following operators (in 
order of decreasing precedence): 

! The ! operator specifies the negation of the next primary (i.e., 1 
-newer file is true if the current file is not newer than file.). This is 
the equivalent of the logical “not” operator. 

-o Placing the -o operator between two primaries creates an expres- 
sion that is true if either of the two primaries is true. It should be 
used with parentheses (i.e., X -perm 644 -o -perm 664 \) is true if 
the current file has permissions 644 or 664). This is equivalent to 
the logical “inclusive or” operator. 

Note that placing two primaries next to each other is the equivalent of 
the logical “and” operation. The precedence of this operation is less 
than that of the ! operator but greater than that of the -o operator. 

Examples 



The following command searches for files named chapterl in the 
current directory and all directories below it and sends the pathname 
of any such files it finds to the standard output: 

find . -name chapterl -print 

The following removes all files named core or with names ending in 
.out that have not been accessed in the last seven days. 

find / \( -name core -o -name "*.out" \) -atime +1 -exec rm {} \ 

Files 



/etc/pass wd User names and uids 

/etc/group Group names and gids 

See Also 



cpio(C)(F), sh(C), stat(S), test(C) 

Standards Conformance 



find is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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finger 

finds information about users 

Syntax 

finger [ -bfilpqsw 1 [loginl [login2 ...] J 

Description 



By default finger lists the login name, full name, terminal name and 
write status (as a before the terminal name if write permission is 
denied), idle time, login time, office location, and phone number (if 
they are known) for each current user. (Idle time is minutes if it is a 
single integer, hours and minutes if a colon (:) is present, or days and 
hours if a “d” is present.) 

A longer format also exists and is used by finger whenever a list of 
names is given. (Account names as well as first and last names of 
users are accepted.) This is a multiline format; it includes all the in- 
formation described above as well as the user’s home directory and 
login shell, any plan which the person has placed in the file .plan in 
their home directory, and the project on which they are working from 
the file .project which is also in the home directory. 

finger options are: 

-b Briefer long output format of users. 

-f Suppresses the printing of the header line (short format). 

-i Quick list of users with idle times. 

-1 Forces long output format. 

-p Suppresses printing of the .plan files. 

-q Quick list of users. 

-s Forces short output format. 

-w Forces narrow format list of specified users. 
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Files 



FINGER (C) 



/etc/utmp Who file 

/etc/passwd User names, offices, phones, login directories, and shells 

$HOME/.plan Plans 

$HOME/.project Projects 

See Also 



who(C), w(C) 

Credit 



This Utility was developed at the University of California at Berkeley 
and is used with permission. 

Notes 



Only the first line of the .project file is printed. 

Entries in the /etc/passwd file have the following format: 

login name.'user passworcl( coded): user ID '.group ID: comments :home 
directory: login shell 

The comment field corresponds to what appears in the finger output. 
For example, in the following /etc/passwd entry: 



blf : * : 47 : 5 : Brian Foster, Mission, x70, 767-1234 
: /u/blf : /bin/ sh 

the comment field, “Brian Foster, Mission, x70, 767-1234“ , contains 
data for the “In Real Life” , “Office” , and “Home Phone” , columns 
of the finger listings. 

Idle time is computed as the elapsed time since any activity on the 
given terminal. This includes previous invocations of finger which 
may have modified the terminal’s corresponding device file /dev/tty??. 
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fixhdr 

changes executable binary file headers 

Syntax 

fixhdr option files 

Description 



fixhdr changes the header of output files created by link editors or 
assemblers. The kinds of modifications include changing the format of 
the header, the fixed stack size, the standalone load address, and sym- 
bol names. 

Using fixhdr allows the use of binary executable files, created under 
other versions or machines, by simply changing the header informa- 
tion so that it is usable by the target cpu. 

These are the options to fixhdr : 

-xa Change the x.out format of the header to the a.out format. 

-xb Change the x.out format of the header to the b.out format. 

-x4 Change the x.out format of the header to the 4.2BSD a.out 

format. 

-x5 [-n] Change the x.out format of the header to Altos UNIX Sys- 
tem V a.out format. The -n flag causes leading under- 
scores on symbol names to be passed with no 
modifications. 

-ax -c [11,86] 

Change the a.out format of the header to the x.out format. 
The -c flag specifies the target CPU. 11 specifies a PDP- 
11 CPU. 86 specifies one of the 8086 family of CPUs 
(8086, 8088, 80186, 80286 or 80386). 

-bx Change the b.out format of the header to the x.out format. 

-5x [-n] Change the Altos UNIX System V a.out format of the 
header to the x.out format. The -n flag causes leading 
underscores on symbol names to be passed with no 
modifications. 
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-86x Add the x.out header format to the 86rel object module 

format. See 86rel(F). 

-F num Add (or change) the fixed stack size specified in the x.out 
format of the header, num must be a hexadecimal num- 
ber. 

-A num Add (or change) the standalone load address specified in 
the x.out format of the header, num must be a hexadeci- 
mal number. 

-M[smlh] Change the model of the x.out or 86rel format. Model 
refers to the compiler model specified when creating the 
binary, s refers to small model, m refers to medium 
model, 1 refers to large model, and h refers to huge model. 

-V [2,3,5,7] Change the version of XENIX specified in the header. 
XENIX version 2 was based on UNIX Version 7. 

-s sl=s2 [-S s3=s4] 

Change symbol names, where symbol name si is changed 
to s2. 

-r Ensure that the resolution table is of non-zero size. 

-C cpu Set the cpu type, cpu can be 186, 286, 386, 8086, others. 

Files 



/usr/bin/fixhdr 

See Also 



a.out(F), 86rel(F) 

Notes 



Give fixhdr one option at a time. If you need to make more than one 
kind of modification to a file, use fixhdr on the original file. Then use it 
again on the fixhdr output, specifying the next option. Copy the origi- 
nal file if you need an unmodified version as fixhdr makes the 
modifications directly to the file. 

Value Added 



fixhdr is an extension of AT&T System V provided by Altos UNIX 
System V. 
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format 

format floppy disks and mini-cartridge tapes 
Syntax 

format [-n] [-v] [-f] [-q] [device] [-i interleave] 

Description 



format formats diskettes for use on an Altos UNIX System V system. 
It may be used either interactively or from the command line. The 
default drive is /dev/rfdO. 

Options 



The following command line options are available: 

-f Suppresses the interactive feature. The format program does not 
wait for user-confirmation before starting to format the diskette. 
Regardless of whether or not you run format interactively, track 
and head information is displayed. 

device 

This specifies the device to be formatted. The default device is 
/dev/rfdO . 

-i interleave 

Specifies the interleave factor. 

-q Quiet option. Suppresses the track and head output information 
normally displayed. Although this option does not suppress the 
interactive prompt, it would typically be used with -f to produce no 
output at all. 

-V Specifies format verification. 

-n Specifies that the diskette is not to be verified (overrides verify 
entry in /etc/default/format). 

The file /etc/default/format is used to specify the default device to be 
formatted and whether or not each diskette is to be verified. The 
entries must be in the format DEVICE=/dev/rfdnnn and 
VERIFY=[yYnN], as in the following example: 
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DEVICE=/ dev/r f dO 9 6ds 1 5 
VERIFY=y 

The device must be a character (raw) device. 

Usage 



To run format interactively, enter: 
format 

followed by any of the legal options except -f, and press RETURN. 
When you mn format interactively, you see the prompt: 



insert diskette in drive and press return when ready 

When you press RETURN at this prompt, format begins to format the 
diskette. 

If you specify the -f option, you do not see this prompt. Instead, the 
program begins formatting immediately upon invocation. 

Unless you specify the -q option, format displays which track and 
head it is currently on: 



track # head # 

The number signs above are replaced by the actual track and head in- 
formation. 

Files 



/etc/default/format 
/dev/rfd[0 - n] 

See Also 

fd(HW) 

Notes 



The format utility does not format floppies for use under DOS; use the 
dosformat command documented in dosiC). 
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Altos UNIX System V systems require error free floppies. 

It is not advisable to format a low density (48tpi) diskette on a high 
density (96tpi) floppy drive. Diskettes written on a high density drive 
should be read on high density drives. A low density diskette written 
on a high density drive may not be readable on a low density drive. 

The device ! dev! install is used only for installing and reading floppies. 
Attempts made to format this device may result in an error. 
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fuser 

Identify processes using a file or file structure 
Syntax 

/etc/fuser [-ku]/i/e... I resource... [-] [[-ku]/i/c... I resource...] 

Description 



The fuser utility displays the process IDs of processes that are using 
the files or remote resources specified as arguments. Each process ID 
is followed by a letter code, interpreted as follows if the process is 
using the file as: 

c current directory 

p parent of its current directory (only when the file is being used 
by the system) 

r root directory 

For block special devices with mounted filesystems, all processes 
using any file on that device are listed. For remote resource names, all 
processes using any file associated with that remote resource (Remote 
File Sharing) are reported, (fuser cannot use the mount point of the 
remote resource; it must use the resource name.) For all other types of 
files (e.g., text files, executables, directories, devices), only the pro- 
cesses using the specified file are reported. 

The following options may be used mih fuser: 

-u The user login name, in parentheses, also follows the process 
ID. 

-k The SIGKILL signal is sent to each process. Since this option 
spawns kills for each process, the kill messages may not show 
up immediately (see kill(S)). 

If more than one group of files is specified, the options any be 
specified again for each additional group of files. A lone dash canceis 
the options currently in force; then, the new set of options applies to 
the next group of files. 

The process IDs are printed as a single line on the standard output, 
separated by spaces and terminated with a single newline. All other 
output is written to standard error. 
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You cannot list processes using a particular file from a remote 
resource mounted on your machine. You can only use the resource 
name as an argument. 

Any user with permission to read /dev/kmem and /dev/mem can use 
fuser. Only the superuser can terminate another user’s process, how- 
ever. 



Files 



/unix 


for system namelist 


/dev/kmem 


for system image 


/dev/mem 


also for system image 


See Also 





mount(ADM), ps(C), kill(S), signal(S) 
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getopt 

parses command options 

Syntax 



set -- 'getopt opts tring $*' 

Description 



getopt is used to check and break up options in command lines for 
parsing by shell procedures, optstring is a string of recognized option 
letters (see getopt (S)). If a letter is followed by a colon, the option is 
expected to have an argument which may or may not be separated 
from it by whitespace. The special option -- is used to delimit the end 
of the options, getopt will place -- in the arguments at the end of the 
options, or recognize it if used explicitly. The shell arguments ($1 $2 . 

. .) are reset so that each option is preceded by a dash (-) and in its own 
shell argument. Each option argument is also in its own shell argu- 
ment. 

Example 



The following code fragment shows how one can process the argu- 
ments for a command that can take the options a and b, and the option 
o, which requires an argument: 



set - - ' getopt abo : $* ' 

if [ $? != 0 ] 

then 

echo "usage: $0 [-a | -b] [-o <arg>] " 
exit 2 
fi 

for i in $* 
do 

case $i in 

-a I -b) shift; FLAG=$i;; 

-o) OARG=$3; shift; shift;; 

- -) shift; break;; 

esac 

done 



This code will accept any of the following as equivalent: 



cmd -aoarg 
cmd -a -o arg 
cmd -oarg -a 
cmd -a -oarg — 
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See Also 



GETOPT (C) 



sh(C), getopt(S) 

Diagnostics 



getopt prints an error message on the standard error when it 
encounters an option letter not included in optstring . 

Notes 



The “Syntax” given for this utility assumes the user has a sh(C) shell. 

Standards Conformance 



getopt is conformant with: 

AT&TSVID Issue 2, Select Code 307-127. 
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getopts, getoptcvt 

parses command options 

Syntax 

getopts optstring name [arg . . .] 
/usr/lib/getoptcvt [-b] file 

Description 



The getopts command is used by shell procedures to parse positional 
parameters and to check for legal options. It supports all applicable 
rules of the command syntax standard [see Rules 3-10, intro (C)]. It 
should be used in place of the getopt(C) command. (See the Notes 
below.) 

This feature is only available in the Bourne shell. 

optstring must contain the option letters the command using getopts 
will recognize; if a letter is followed by a colon, the option is expected 
to have an argument, or group of arguments, which must be separated 
from it by white space. 

Each time it is invoked, getopts will place the next option in the shell 
variable name and the index of the next argument to be processed in 
the shell variable OPTIND. Whenever the shell or a shell procedure is 
invoked, OPTIND is initialized to 1. 

When an option requires an option-argument, getopts places it in the 
shell variable OPTARG. 

If an illegal option is encountered, ? will be placed in name . 

When the end of options is encountered, getopts exits with a non-zero 
exit status. The special option may be used to delimit the end of 
the options. 

By default, getopts parses the positional parameters. If extra argu- 
ments {arg . . .) are given on the getopts command line, getopts will 
parse them instead. 

The I usrilibi getoptcvt command reads the shell script in file , converts 
it to use getopts (C) instead of getopt (C), and writes the results to the 
standard output. 
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-b the results of running liisrilibigetoptcvt will be portable to earlier 
UNIX releases. Iiisrilibi getoptcvt modifies the shell script in file so 
that when the resulting shell script is executed, it determines at run 
time whether to invoke getopts(C) or getopt(C). 

So all new commands will adhere to the command syntax standard 
described in intro {C), they should use getopts{C) or getopt(S) to 
parse positional parameters and check for options that are legal for 
that command (see Notes below). 

Examples 



The following fragment of a shell program shows how one might pro- 
cess the arguments for a command that can take the options a or b, as 
well as the option o, which requires an option-argument: 

while getopts abo : c 
do 

case $c in 

a I b) FLAG=$c; ; 

o ) 0 ARG= $ OP T ARG ; ; 

?) echo $USAGE 

exit 2 ; ; 

esac 

done 

shift 'expr $OPTIND - 1' 

This code will accept any of the following as equivalent: 

cmd -a -b -o "xxx z yy" 
cmd -a -b -o "xxx z yy" -- 
cmd -ab -o xxx,z,yy 
cmd -ab -o "xxx z yy" 
cmd -o xxx,z,yy -b -a 

See Also 



intro(C), sh(C), getopt(S) 

Notes 



Although the following command syntax rule [see Intro (C)] relaxa- 
tions are permitted under the current implementation, they should not 
be used because they may not be supported in future releases of the 
system. As in the Examples section above, a and b are options, and 
the option o requires an option-argument: 

cmd -aboxxx file (Rule 5 violation: options with option- 

arguments must not be grouped with other 
options.) 



January 16, 1991 



GETOPTS-2 




GETOPTS (C) 



GETOPTS (C) 



cmd -ab -oxxx file (Rule 6 violation: there must be white space 
after an option that takes an option- 
argument.) 

Changing the value of the shell variable OPTIND or parsing different 
sets of arguments may lead to unexpected results. 

Diagnostics 



getopts prints an error message to the standard error when it 
encounters an option letter not included in optstring , 
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gets 

gets a string from the standard input 
Syntax 



gets [ String ] 

Description 



gets can be used with csh{C) to read a string from the standard input. 
If string is given it is used as a default value if an error occurs. The 
resulting string (either string or as read from the standard input) is 
written to the standard output. If no string is given and an error 
occurs, gets exits with exit status 1. 

See Aiso 



line(C), csh(C) 
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greek 

select terminal filter 

Syntax 



greek [ -Tterminal ] 

Description 



greek is a filter that reinterprets the extended character set, as well as 
the reverse and half-line motions, of a 128-character TELETYPE 
Model 37 terminal for certain other terminals. Special characters are 
simulated by overstriking, if necessary and possible. If the argument 
is omitted, greek attempts to use the environment variable $TERM 
[see environQA)]. Currently, the following terminals are recognized: 



300 


DASI 300. 


300-12 


DASI 300 in 12-pitch. 


300s 


DASI 300s. 


300S-12 


DASI 300s in 12-pitch. 


450 


DASI 450. 


450-12 


DASI 450 in 12-pitch. 


1620 


Diablo 1620 (alias DASI 450). 


1620-12 


Diablo 1620 (alias DASI 450) in 12-pitch. 


2621 


Hewlett-Packard 2621, 2640, and 2645. 


2640 


Hewlett-Packard 2621, 2640, and 2645. 


2645 


Hewlett-Packard 2621, 2640, and 2645. 


4014 


Tektronix 4014. 


hp 


Hewlett-Packard 2621, 2640, and 2645. 


tek 


Tektronix 4014. 



Fiies 



/usrA)in/300 

/usr/bin/300s 

/usr/bin/4014 

/usr/bin/450 

/usr/bin/hp 

See Aiso 



300(C), 4014(C), 450(C), hp(C), tplot(ADM), environ(M), term(M) 
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grep, egrep, fgrep 



searches a file for a pattern 

Syntax 




grep [ -bchlnsvy ] [ -e expression ; 


1 [ files ] 


egrep [ -bchlnv ] [ -e expression ] 


[ files ] 


fgrep [ -bclnvxy ] [ -f expfile ] [ files ] 

Description 



Commands of the grep family search the input files (or standard input 
if no files are specified) for lines matching a pattern. Normally, each 
matching line is copied to the standard output. If more than one file is 
being searched, the name of the file in which each match occurs is 
also written to the standard output along with the matching line 
(unless the -h option is used, see below). 

grep patterns are limited regular expressions in the style of ed{C). 
grep uses a compact nondeterministic algorithm, egrep patterns are 
full regular expressions; it uses a fast deterministic algorithm that 
sometimes needs exponential space, fgrep patterns are fixed strings, 
fgrep is fast and compact. The following options are recognized: 

-V All lines but those matching are displayed. 

-X Displays only exact matches of an entire line, (fgrep only.) 

-c Only a count of matching lines is displayed. 

-1 Only the names of files with matching lines are displayed, 
separated by newlines. 

-h Prevents the name of the file containing the matching line from 
being prepended to that line. Used when searching multiple 
files. (This option works with grep and egrep only.) 

-n Each line is preceded by its relative line number in the file. 

-b Each line is preceded by the block number on which it was 

found. This is sometimes useful in locating disk block num- 
bers by context. 
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-s Suppresses error messages produced for nonexistent or unread- 
able files, (grep only). Note that the -s option will not 
suppress error messages generated by the -f option. 

-y Turns on matching of letters of either case in the input so that 
case is insignificant. Conversion between uppercase and 
lowercase letters is dependent on the locale setting, -y does 
not work with egrep . 

-e expression oxstrings 

Same as a expression argument, but useful when the 

expression begins with a dash (-). 

-f expfile 

The regular expression for grep or egrep, or strings list for 
fgrep is taken from the expfile. 

In all cases (except with -h) the filename is output if there is more 
than one input file. Care should be taken when using the characters $, 
[» ", 1 5 (, ), and \ in expression, because they are also meaningful to 
the shell. It is safest to enclose the entire expression or strings argu- 
ment in single quotation marks. For example: 

grep ’[Ss]omeone’ text. file 

This command would find all lines containing the word “someone” in 
the file text.file, whether the initial “s” is uppercase or lowercase. 

Multiple strings can be specified in fgrep without using a separate 
strings file by using the quoting conventions of the shell to imbed 
newlines in the string argument. For example, if you were using the 
Bourne shell (sh(C)) you might enter the following on the command 
line: 

fgrep 'Someone 
someone' text.file 

This would have the same effect as the grep example above. See the 
csh(C) manual page for ways to imbed newlines in a string when 
using csh(C). 

egrep accepts regular expressions as in ed(C), with the addition of the 
following: 

- A regular expression followed by a plus sign (+) matches one or 
more occurrences of the regular expression. 

- A regular expression followed by a question mark (?) matches 0 or 
1 occurrences of the regular expression. 
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- Two regular expressions separated by a vertical bar (I) or by a 
newline match strings that are matched by either regular expres- 
sion. 

- A regular expression may be enclosed in parentheses ( ) for group- 
ing. For example: 

egrep '([Ss]omel[Aa]ny)one" text.file 

This example displays all lines in text.file containing the words 
“someone” or “anyone”, whether or not they are spelled with initial 
capital letters. Without the parentheses, this example would display 
all lines containing the words “some” or “anyone” (because the vert- 
ical bar (I) operator is of lower precedence than concatenation, see 
below). 

Because of the algorithm used, egrep does not support extended 
ranges as in ed{C)\ Ranges like [a-z] are interpreted on the basis of 
the machine’s collating sequence, not the collating sequence defined 
by the locale, grep supports col(C) extended ranges. 

The \( and \) operators, supported by ed(C), are not supported by 
egrep. 

The order of precedence of operators is [ ], then * ? + , then concatena- 
tion, then backslash (\) with newline or vertical bar (|). 

See Also 



coltbl(M), ed(C), locale(M), sed(C), sh(C) 

Diagnostics 



Exit status is 0 if any matches are found, 1 if no matches are found, 
and 2 for syntax errors or inaccessible files. 

Notes 



Ideally there should be only one grep, but there isn’t a single algo- 
rithm that spans a wide enough range of space-time tradeoffs. 

Lines are limited to 256 characters. Longer lines are truncated. 

When using grep with the -y option, the search is not made totally 
case insensitive in character ranges specified within brackets. 
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Standards Conformance 



egrep,fgrep and grep are conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 



GREP (C) 
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grpcheck 

checks group file 

Syntax 

grpcheck [file] 

Description 



grpcheck verifies all entries in the group file. This verification 
includes a check of the number of fields, group name, group ID, and 
whether all login names appear in the password file. The default group 
file is /etc/group. 

Fiies 



/etc/group 

/etc/passwd 

See Also 



pwcheck(C), group(F), passwd(F) 

Diagnostics 



Group entries in /etc/group with no login names are flagged. 
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hd 

displays files in hexadecimal format 

Syntax 



hd [ -format [ -s offset ] [ -n count ] [ file ] ... 

Description 



The hd command displays the contents of files in hexadecimal, octal, 
decimal, and character formats. Control over the specification of 
ranges of characters is also available. The default behavior is with the 
following flags set: “-abx -A”. This says that addresses (file offsets) 
and bytes are printed in hexadecimal and that characters are also 
printed. If no file argument is given, the standard input is read. 

Options include: 

-s ojfset Specify the beginning offset in the file where printing is 
to begin. If no ‘file’ argument is given, or if a seek fails 
because the input is a pipe, ‘offset’ bytes are read from 
the input and discarded. Otherwise, a seek error will 
terminate processing of the current file. 

The offset may be given in decimal, hexadecimal (pre- 
ceded by ‘Ox’), or octal (preceded by a ‘0’). It is option- 
ally followed by one of the following multipliers: w, 1, 
b, or k; for words (2 bytes), long words (4 bytes), half 
kilobytes (512 bytes), or kilobytes (1024 bytes), respec- 
tively. Note that this is the one case where “b” does 
not stand for bytes. Since specifying a hexadecimal 
offset in blocks would result in an ambiguous trailing 
‘b’, any offset and multiplier may be separated by an 
asterisk (*). 

-n count Specify the number of bytes to process. The count is in 
the same format as offset, above. 

Format Flags 



Format flags may specify addresses, characters, bytes, words (2 bytes) 
or longs (4 bytes) to be printed in hex, decimal, or octal. Two special 
formats may also be indicated: text or ascii. Format and base 
specifiers may be freely combined and repeated as desired in order to 
specify different bases (hexadecimal, decimal or octal) for different 
output formats (addresses, characters, etc.). All format flags appearing 
in a single argument are applied as appropriate to all other flags in that 
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argument. 

acbwlA 

Output format specifiers for addresses, characters, bytes, words, 
longs and ascii respectively. Only one base specifier will be used 
for addresses. The address will appear on the first line of output 
that begins each new offset in the input. 

The character format prints all printable characters without 
change, special C escapes as defined in the language, and the 
remaining values in the specified base. 

The ascii format prints all printable characters without change, and 
all others as a period (.). This format appears to the right of the 
first of other specified output formats. A base specifier has no 
meaning with the ascii format. If no other output format (other than 
addresses) is given, bx is assumed. If no base specifier is given, all 
of xdo are used. 

xdo 

Output base specifiers for hexadecimal, decimal and octal. 

t Print a text file, each line preceded by the address in the file. Nor- 
mally, lines should be terminated by a \n character; but long lines 
will be broken up. Control characters in the range 0x00 to Ox If are 
printed as to Bytes with the high bit set are preceded by 
a tilde ("') and printed as if the high bit were not set. The special 
characters (", “, \) are preceded by a backslash (\) to escape their 
special meaning. As special cases, these two values are 
represented numerically as M??’ and ‘\377’. This flag will over- 
ride all output format specifiers except addresses. 

If no output format is given, but a base specifier is present, the output 
format is set to -acbwl. If no base specifier is given, but an output for- 
mat is present, the base specifier is set to -xdo. If neither is present, 
the format flag is set to -abx -A. 

Value Added 



hd is an extension of AT&T System V provided in Altos UNIX System 
V. 
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head 

prints the first few lines of a file 

Syntax 

head [ -count ] [ file ... ] 

Description 



This filter prints the first count lines of each of the specified files. If 
no files are specified, head reads from the standard input. If no count 
is specified, then 10 lines are printed. 

See Aiso 

tail(C) 

Credit 



This Utility was developed at the University of California at Berkeley 
and is used with permission. 
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hello 

send a message to another user 

Syntax 

hello user [ tty ] 

Description 



hello sends messages from one user to another. When first called, 
hello displays the following message: 

Message from sender' s-system! sender' s-name sender' s-tty 

The recipient of the message should write back at this point. Commu- 
nication continues until an interrupt is sent. (On most terminals, press- 
ing the Del key sends an interrupt.) At that point hello prints “(end of 
message)” on the other terminal, and exits. 

To write to a user who is logged in more than once, the user can 
employ the tty argument to specify the appropriate terminal name. 
The who(C) command can be used to determine the correct terminal 
name. 

Permission to write may be allowed or denied by the recipient, using 
the mesg command. Writing is allowed by default. Certain com- 
mands, such as nroff and pr, prohibit messages in order to prevent 
disruption of output. 

If the character ! is found at the beginning of a line, hello calls the 
shell to execute the rest of the line as a command. 

The following protocol is suggested for using hello. When first writ- 
ing to another user, the sender should wait for that user to write back 
before sending a message. Each party should end each message with a 
signal indicating that the other may reply: o for “over” is conven- 
tional. The signal oo for “over and out” is suggested when conversa- 
tion is about to be terminated. 

Files 



/etc/utmp 

/bin/sh 
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mesg(C), who(C), mail(C) 

Value Added 



hello is an extension of AT&T System V provided in Altos UNIX Sys- 
tem V. 
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hostid 

Print unique hardware ID 
Syntax 

hostid 

Description 



The hostid utility prints the system’s unique hardware ID to standard 
output. This ID is set at the factory during manufacture. 

If a hardware ID is not available (for example, on a non-Altos ma- 
chine), the operating system serial number is returned instead. 

Vaiue Added 



hostid is an extension of AT&T System V provided by Altos UNIX 
System V. 
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hp 

handle special functions of Hewlett-Packard terminals 

Syntax 



hp [ -e ] [ -m ] 

Description 



hp supports special functions of the Hewlett-Packard 2640 series of 
terminals, with the primary purpose of producing accurate representa- 
tions of most nrojf oni^ui. A typical usage is in conjunction with text 
processing software: 

nroff -h files . . . | hp 

Regardless of the hardware options on your terminal, hp tries to do 
sensible things with underlining and reverse line-feeds. If the termi- 
nal has the “display enhancements” feature, subscripts and super- 
scripts can be indicated in distinct ways. If it has the “mathematical- 
symbol” feature, Greek and other special characters can be displayed. 

The flags are as follows: 

-e It is assumed that your terminal has the “display enhancements” 
feature, and so maximal use is made of the added display modes. 
Overstruck characters are presented in the Underlined mode. 
Superscripts are shown in Half-bright mode, and subscripts in 
Half-bright, Underlined mode. If this flag is omitted, hp assumes 
that your terminal lacks the “display enhancements” feature. In 
this case, all overstruck characters, subscripts, and superscripts are 
displayed in Inverse Video mode, i.e., dark-on-light, rather than the 
usual light-on-dark. 

-m 

Requests minimization of output by changing newlines to "M’s. 
Any contiguous sequence of 3 or more new-lines is converted into 
a sequence of only 2 new-lines; i.e., any number of successive 
blank lines produces only a single blank output line. This allows 
you to retain more actual text on the screen. 

With regard to Greek and other special characters, hp provides the 
same set as 300{C), except that “not” is approximated by a right 
arrow, and only the top half of the integral sign is shown. 
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Diagnostics 



line too long if the representation of a line exceeds 1,024 characters. 
The exit codes are 0 for normal termination, 2 for all errors. 

See Also 



300(C), greek(C) 

Notes 



An “overstriking sequence” is defined as a printing character fol- 
lowed by a backspace followed by another printing character. In such 
sequences, if either printing character is an underscore, the other print- 
ing character is shown underlined or in Inverse Video; otherwise, only 
the first printing character is shown (again, underlined or in Inverse 
Video). Nothing special is done if a backspace is adjacent to an ASCII 
control character. Sequences of control characters (e.g., reverse line- 
feeds, backspaces) can make text “disappear”. In particular, tables 
generated by tbl (CT) that contain vertical lines will often be missing 
the lines of text that contain the “foot” of a vertical line, unless the 
input to hp is piped through coliC), 

Although some terminals do provide numerical superscript characters, 
no attempt is made to display them. 
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hwconfig 

read the configuration information 

Syntax 

/etc/hwconfig [-nlh] [-f filename] [ [-] param] [ [-] param=val] ... 

Description 



hwconfig returns the configuration information contained in the file 
/usr/adm/hwconfig or the file specified on the command line with the 
-f filename option. Using combinations of the remaining options, the 
user can view as much information as needed from the configuration 
file. The display format is as follows: 

magic char device jiame base+ finish vec dma rest 



where: 



magicjchar 


is the character % 


devicejiame 


is the name of the device driver 


base+finish 


is the starting and the finishing addresses of 
the driver working space 


vec 


is the interrupt vector number 


dma 


is the dma channel number 


rest 


is a possibly empty list of parameter=value 



pairs 

The default hwconfig display looks similar to this: 
device address vector dma corment 



fpu - 35 
floppy 0x3F2-0x3F7 06 
serial 0x2F8-0x2FF 03 
parallel 0x378-0x37A 07 
console - 

disk 0xlF0”0xlF7 36 



type=80387 

2 unit=0 type=96dsl5 

unit=l tYpe=Standard nports=l 
unit=0 

unit=ega type=0 

type=W0 unit=0 cyls=791 hds=16 secs=48 



Options 



-n 



the device name is always printed out. 
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-1 


the long format of the device configuration 
content is used. 


-h 


uses the long format, with headers. 


-ffile 


uses file as the input file instead of the default 
/usr/adm/hwconfig. 


param 


any of the 12 pre-defined parameters avail- 
able: name, base, offset, vec, dma, unit, type, 
nports, hds, cyls, secs, and drvr. 


-param 


shows all values of param throughout the con- 
figuration file, param can be any valid system 
parameter. 


-param=val 


shows only information from the line where 
param equals the value val. 



The -n, -1 and -h options are in increasing overriding power. That is, if 
-n and -1 are both specified, -1 will be used, param on its own indi- 
cates a query for its corresponding value(s), whereas param=value 
indicates a matching <token,val> pair in the input file. -1 is used by 
default if there are no queries and no explicit option. 

Command line queries, i.e. those with parameters only, are always dis- 
played in short format. 

Examples 



hwconHg The entire contents of the file /usr/adm/hwconfig is 
printed. 

hwconfig base 

All the values of the base parameter found in 
/usr/adm/hwconfig are printed. 

hwconfig -f conf base=300 vec=19 

All entries in conf that match the base and vec values 
given are printed. 

hwconfig name=floppy base 

The name and value of base in /usr/adm/hwconfig for the 
drivers with the nwiQ floppy are printed for all entries. 

hwconfig -n base dma 

The device name associated with the base and dma is dis- 
played. For example: 
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name=scsi base=0x234 dma=4 

hwconfig base dma vec=4 

The base and dma values of all /usr/adm/hwconfig entries with 
matching vec=4 are printed. 

hwconfig -1 base dma vec=4 
is like 

hwconfig -1 vec=4 

except that base and dma values will be printed first, 
hwconfig -h 

Everything is printed in the long format, with a header similar to 
the one shown at boot-up time. It will ignore all queries, but do 
matching on the token values. For example, 

hwconfig -h vec=4 dma=l 

will print in long format, with header, all those entries with vec=4 and 
dma=l 

Files 



/usr/adm/h wcon fig 

Value Added 



hwconfig is an extension of AT&T System V provided in Altos UNIX 
System V. 
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i286emul 

emulate UNIX 80286 

Syntax 

i286emul [ arg ... ] prog286 

Description 



i286emul is an emulator that allows programs from UNIX System V 
Release 2 or Release 3 on the Intel 80286 to run on UNIX System V 
Release 3 on the Intel 80386. 

The Altos UNIX System V system recognizes an attempt to exec(S) a 
286 program, and automatically exec's the 286 emulator with the 286 
program name as an additional argument. It is not necessary to 
specify the i286emul emulator on the command line. The 286 pro- 
grams can be invoked using the same command format as on the 286 
UNIX System V. 

i286emul reads the 286 program’s text and data into memory and maps 
them through the LDT (Local Descriptor Table) (via sysi86{S)) as 286 
text and data segments. It also sets callgate 89 in the GDT (Global 
Descriptor Table) (which is used by 286 programs for system calls) to 
point to a routine in i286emul. i286emul starts the 286 program by 
jumping to its entry point. 

When the 286 program attempts to do a system call, i286emul takes 
control. It does any conversions needed between the 286 system call 
and the equivalent 386 system call, and performs the 386 system call. 
The results are converted to the form the 286 program expects, and the 
286 program is resumed. 

The following are some of the differences between a program running 
on a 286 and a 286 program using i286emul on a 386: 

• A 286 program under i286emul always has 64K in the stack 
segment if it is a large-model process, or 64K in the data seg- 
ment if it is a small-model process. 

• System calls and signal handling use more space on the stack 
under i286emul than it does on a 286. 

• Attempts to unlink or write on the 286 program will fail on the 
286 with ETXTBSY. Under i286emul, they will not fail. 

• ptrace (S) is not supported under i286emul . 
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• The 286 program must be readable for the emulator to read it. 

Files 



/bin/i 286 emul 

The emulator must have this name and be in /bin if it is to be 
automatically invoked when exec(S) is used on a 286 program. 



Notes 



The signal mechanism under the emulator is the System V release 2 
signal mechanism rather than the System V release 3 mechanism. 
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id 

prints user and group IDs and names 

Syntax 

id 

Description 



id writes a message on the standard output, giving the user and group 
IDs and the corresponding names of the invoking process. If the effec- 
tive and real IDs do not match, both are printed. 

See Aiso 



logname(C), getuid(S) 

Standards Conformance 



id is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 



March 1 5, 1 989 



ID-1 







ISMPX(C) 



ISMPX(C) 



ismpx 

return windowing terminal state 

Syntax 



ismpx [-s] 

Description 



The ismpx command reports whether its standard input is connected to 
a multiplexed xr(HW) channel; i.e., whether it’s running under 
layersiC) or not. It is useful for shell scripts that download programs 
to a windowing terminal or depend on screen size. 

The ismpx command prints yes and returns 0 if invoked under 
layers(C)y and prints no and returns 1 otherwise. 

-s Do not print anything; just return the proper exit status. 

Diagnostics 



Returns 0 if invoked under layers(C\ 1 if not. 

See Also 



jwin(C), layers(C), xt(HW) 

Example 



if ismpx -s 
then 

jwin 

fi 
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join 

joins two relations 

Syntax 

join [ options ] filel file2 

Description 



join prints to the standard output a join of the two relations specified 
by the lines oifilel and file2 . IffileJ is a dash (-), the standard input 
is used. 

Filel and file2 must be sorted in increasing ASCII collating sequence 
on the fields on which they are to be joined, normally the first in each 
line. 

There is one line in the output for each pair of lines in filel and file2 
that have identical join fields. The output line normally consists of 
the common field, then the rest of the line from filel , then the rest of 
the line from file2 . 

Fields are normally separated by blank, tab or newline. In this case, 
multiple separators count as one, and leading separators are discarded. 

These options are recognized: 

-an In addition to the normal output, produces a line for each 

unpayable line in file n, where n is 1 or 2. 

-e s Replaces empty output fields by string s. 

-jn m Joins on the mth field of file n. If n is missing, uses the 

mth field in each file. 

-o list Each output line comprises the fields specified in list, 
each element of which has the form n.m, where n is a file 
number and m is a field number. 

-tc Uses character c as a field separator. Every appearance of 

c in a line is significant. 
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See Also 



awk(C), comm(C), sort(C) 

Notes 



With default field separation, the collating sequence is that of sort -b. 
With -t, the sequence is that of a plain sort. 

Standards Conformance 



join is conformant with: 

AT&TSVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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jterm 

reset layer of windowing terminal 

Syntax 



jterm 

Description 



The jterm command is used to reset a layer of a windowing terminal 
after downloading a terminal program that changes the terminal 
attributes of the layer. It is useful only under layers(^). In practice, it 
is most commonly used to restart the default terminal emulator after 
using an alternate one provided with a terminal -specific application 
package. For example, on the AT&T TELETYPE 5620 DMD termi- 
nal, after executing the hp2621(C) command in a layer, issuing the 
Jterm command will restart the default terminal emulator in that layer. 

Diagnostics 



Returns 0 upon successful completion, 1 otherwise. 

Notes 



The layer that is reset is the one attached to standard error; that is, the 
window you are in when you type the Jterm command. 

See Aiso 



layers(C) 



March 1 5, 1 989 



JTERM-1 









JWIN (C) 



JWIN (C) 



jwin 

print size of layer 

Syntax 

jwin 

Description 



The jwin command runs only under layers{C) and is used to determine 
the size of the layer associated with the current process. It prints the 
width and the height of the layer in bytes (number of characters across 
and number of lines, respectively). For bit-mapped terminals only, it 
also prints the width and height of the layer in bits. 

Diagnostics 



Returns 0 on successful completion, 1 otherwise. 

If layers(C) has not been invoked, an error message is printed: 
jwin: not mpx 



Note 



The layer whose size is printed is the one attached to standard input; 
that is, the window you are in when you type the jwin command. 

See Also 



layers(C) 

Example 



In the following example, the user input is in bold: 
$ jwin 

bytes: 86 25 

bits : 780406 
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\ 

% 



kill 

terminates a process 

Syntax 



kill [ -signo ] processid ... 

Description 



kill sends signal 15 (terminate) to the specified process(es). This will 
normally kill processes that do not catch or ignore the signal. The 
process number of each asynchronous process (background process) 
started with & is reported by the shell (unless more than one process is 
started in a pipeline, in which case the number of the last process in 
the pipeline is reported). Process numbers can also be found by using 
ps{C). 

For example, if process number 0 is specified, all processes in the pro- 
cess group are signaled. 

The killed process must belong to the current user unless he is the 
super-user. 

If a signal number preceded by - is given as the first argument, that 
signal is sent instead of the terminate signal (see signal (S)). In partic- 
ular “kill -9 ...” is a sure kill. 

See Also 



ps(C), sh(C), kill(S), signal(S) 

Standards Conformance 



kill is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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ksh, rksh 

KornShell, a standard/restricted command and pro- 
gramming language 

Syntax 



ksh [ ±aefhikmnoprstuvx ] [ ±o option ] . . . [ -c string ] [ arg . . . ] 
rksh [ laefhikmnoprstuvx ] [ ±o option ] . . . [ -c string ] [ arg . . . ] 

Description 



ksh is a command and programming language that executes com- 
mands read from a terminal or a file, rksh is a restricted version of the 
command interpreter ksh\ it is used to set up login names and execu- 
tion environments whose capabilities are more controlled than those 
of the standard shell. See Invocation below for the meaning of argu- 
ments to the shell. 

Definitions 

A metacharacter is one of the following characters: 

;&()]<> new-line space tab 

A blank is a tab or a space. An identifier is a sequence of letters, 
digits, or underscores starting with a letter or underscore. Identifiers 
are used as names for functions and named parameters . A word is a 
sequence of characters separated by one or more non-quoted meta- 
characters . 

A command is a sequence of characters in the syntax of the shell lan- 
guage. The shell reads each command and carries out the desired 
action either directly or by invoking separate utilities. A special com- 
mand is a command that is carried out by the shell without creating a 
separate process. Except for documented side effects, most special 
commands can be implemented as separate utilities. 

Commands 

A simple-command is a sequence of blank separated words which may 
be preceded by a parameter assignment list. (See Environment 
below). The first word specifies the name of the command to be exe- 
cuted. Except as specified below, the remaining words are passed as 
arguments to the invoked command. The command name is passed as 
argument 0 (see exec{S)). The value of a simple-command is its exit 
status if it terminates normally, or (octal) 200+status if it terminates 
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abnormally (see signal (S) for a list of status values). 

A pipeline is a sequence of one or more commands separated by | . 
The standard output of each command but the last is connected by a 
pipe(S) to the standard input of the next command. Each command is 
run as a separate process; the shell waits for the last command to ter- 
minate. The exit status of a pipeline is the exit status of the last com- 
mand. 

A list is a sequence of one or more pipelines separated by &, &&, 
or I |, and optionally terminated by &, or |&. Of these five sym- 
bols, &, and | & have equal precedence, which is lower than that of 
&& and I |. The symbols && and | | also have equal precedence. A 
semicolon (;) causes sequential execution of the preceding pipeline; 
an ampersand (&) causes asynchronous execution of the preceding 
pipeline (i.e., the shell does not wait for that pipeline to finish). The 
symbol |& causes asynchronous execution of the preceding command 
or pipeline with a two-way pipe established to the parent shell. The 
standard input and output of the spawned command can be written to 
and read from by the parent Shell using the -p option of the special 
commands read and print described later. The symbol && ( | | ) 
causes the list following it to be executed only if the preceding pipe- 
line returns a zero (non-zero) value. An arbitrary number of new-lines 
may appear in a list, instead of a semicolon, to delimit a command. 

A command is either a simple-command or one of the following. 
Unless otherwise stated, the value returned by a command is that of 
the last simple-command executed in the command. 

for identifier [ in word . . . ] ;do list ;done 

Each time a for command is executed, identifier is set to the next 
word taken from the in word list. If in word ... is omitted, then 
the for command executes the do list once for each positional 
parameter that is set (see Parameter Substitution below). Execu- 
tion ends when there are no more words in the list. 

select identifier [ in word ... ] ;do list ;done 

A select command prints on standard error (file descriptor 2), the 
set of words, each preceded by a number. If in word ... is omit- 
ted, then the positional parameters are used instead (see Parameter 
Substitution below). The PS3 prompt is printed and a line is read 
from the standard input. If this line consists of the number of one 
of the listed words, then the value of the parameter identifier is set 
to the word corresponding to this number. If this line is empty the 
selection list is printed again. Otherwise the value of the parame- 
ter identifier is set to null. The contents of the line read from stan- 
dard input is saved in the parameter REPLY. The list is executed 
for each selection until a break or end- of file is encountered. 

case word in [ [ ( jpattern [ | pattern ] . . . ) list ;; ] . . . esac 

A case command executes the list associated with the first pattern 
that matches word. The form of the patterns is the same as that 
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used for file-name generation (see File Name Generation below). 

if list ;then list [ elif list ;then list ] ...[ ;else list ] ;fi 

The list following if is executed and, if it returns a zero exit status, 
the list following the first then is executed. Otherwise, the list fol- 
lowing elif is executed and, if its value is zero, the list following 
the next then is executed. Failing that, the else list is executed. If 
no else list or then list is execut^, then the if command returns a 
zero exit status. 

while list ;do list ;done 
until list ;do list ;done 

A while command repeatedly executes the while list and, if the 
exit status of the last command in the list is zero, executes the do 
list; otherwise the loop terminates. If no commands in the do list 
are executed, then the while command returns a zero exit status; 
until may be used in place of while to negate the loop termination 
test. 

(list) 

Execute list in a separate environment. Note, that if two adjacent 
open parentheses are needed for nesting, a space must be inserted 
to avoid arithmetic evaluation as described below. 

{ list ;} 

list is simply executed. Note that unlike the metacharacters ( and 
), { and } are reserved words and must at the beginning of a line or 
after a ; in order to be recognized. 

[[expression)) 

Evaluates expression and returns a zero exit status when expres- 
sion is true. See Conditional Expressions below, for a description 
of expression. 

function identifier { list ;} 
identifier () { list ;} 

Define a function which is referenced by identifier. The body of 
the function is the list of commands between { and }. (See Func- 
tions below). 

time pipeline 

The pipeline is executed and the elapsed time as well as the user 
and system time are printed on standard error. 

The following reserved words are only recognized as the first word of 
a command and when not quoted: 

if then else elif fi case esac for while until do done 
{ } function select time [[ ]] 
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Comments 

A word beginning with # causes that word and all the following char- 
acters up to a new-line to be ignored. 



Aliasing 

The first word of each command is replaced by the text of an alias if 
an alias for this word has been defined. The first character of an alias 
name can be any non-special printable character, but the rest of the 
characters must be the same as for a valid identifier. The replacement 
string can contain any valid Shell script including the metacharacters 
listed above. The first word of each command in the replaced text, 
other than any that are in the process of being replaced, will be tested 
for aliases. If the last character of the alias value is a blank then the 
word following the alias will also be checked for alias substitution. 
Aliases can be used to redefine special builtin commands but cannot 
be used to redefine the reserved words listed above. Aliases can be 
created, listed, and exported with the alias command and can be 
removed with the unalias command. Exported aliases remain in effect 
for scripts invoked by name, but must be reinitialized for separate 
invocations of the Shell (See Invocation below). 

Aliasing is performed when scripts are read, not while they are exe- 
cuted. Therefore, for an alias to take effect the alias definition com- 
mand has to be executed before the command which references the 
alias is read. 

Aliases are frequently used as a short hand for full path names. An 
option to the aliasing facility allows the value of the alias to be auto- 
matically set to the full pathname of the corresponding command. 
These aliases are called tracked aliases. The value of a tracked alias 
is defined the first time the corresponding command is looked up and 
becomes undefined each time the PATH variable is reset. These 
aliases remain tracked so that the next subsequent reference will 
redefine the value. Several tracked aliases are compiled into the shell. 
The -h option of the set command makes each referenced command 
name into a tracked alias. 

The following exported aliases are compiled into the shell but can be 
unset or redefined: 

autoload= typeset -fu' 
false=det 0' 
functions= typeset -E 
hash= alias -t' 
history =Tc -T 
integer= typeset -i" 
nohup='nohup ' 
r=Tc -e 



March 19, 1990 



KSH-4 




KSH (C) 



KSH (C) 



true=':" 

type= 'whence -v' 



Tilde Substitution 

After alias substitution is performed, each word is checked to see if it 
begins with an unquoted If it does, then the word up to a / is 
checked to see if it matches a user name in the /etc/passwd file. If a 
match is found, the - and the matched login name is replaced by the 
login directory of the matched user. This is called a tilde substitution. 
If no match is found, the original text is left unchanged. A ~ by itself, 
or in front of a /, is replaced by the value of the HOME parameter. A 
~ followed by a + or - is replaced by $PWD and $OLDPWD respec- 
tively. 

In addition, tilde substitution is attempted when the value of a vari- 
able assignment parameter begins with a ~. 



Command Substitution 

The standard output from a command enclosed in parenthesis pre- 
ceded by a dollar sign ( $() ) or a pair of grave accents may be 
used as part or all of a word; trailing new-lines are removed. In the 
second (archaic) form, the string between the quotes is processed for 
special quoting characters before the command is executed. (See 
Quoting below). The command substitution $(cat file) can be 
replaced by the equivalent but faster $(<file). Command substitution 
of most special commands that do not perform input/output redirection 
are carried out without creating a separate process. 

An arithmetic expression enclosed in double parenthesis preceded by 
a dollar sign ( $(()) ) is replaced by the value of the arithmetic expres- 
sion within the double parenthesis. 



Parameter Substitution 

A parameter is an identifier, one or more digits, or any of the charac- 
ters *, @, #, ?, -, $, and ! . A named parameter (a parameter denoted 
by an identifier) has a value and zero or more attributes. Named 
parameters can be assigned values and attributes by using the 
typeset special command. The attributes supported by the Shell are 
described later with the typeset special command. Exported parame- 
ters pass values and attributes to the environment. 

The shell supports a one-dimensional array facility. An element of an 
array parameter is referenced by a subscript. A subscript is denoted 
by a [, followed by an arithmetic expression (see Arithmetic evalua- 
tion below) followed by a ]. To assign values to an array, use set -A 
name value .... The value of all subscripts must be in the range of 0 
through 1023. Arrays need not be declared. Any reference to a named 
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parameter with a valid subscript is legal and an array will be created if 
necessary. Referencing an array without a subscript is equivalent to 
referencing the element zero. 

The value of a named parameter may also be assigned by writing: 
name=value [ name -value ]... 

If the integer attribute, -i, is set for name the value is subject to arith- 
metic evaluation as described below. 

Positional parameters, parameters denoted by a number, may be 
assigned values with the set special command. Parameter $0 is set 
from argument zero when the shell is invoked. 

The character $ is used to introduce substitutable parameters . 
^{parameter} 

The shell reads all the characters from ${ to the matching } as part 
of the same word even if it contains braces or metacharacters. The 
value, if any, of the parameter is substituted. The braces are 
required when parameter is followed by a letter, digit, or under- 
score that is not to be interpreted as part of its name or when a 
named parameter is subscripted. If parameter is one or more digits 
then it is a positional parameter. A positional parameter of more 
than one digit must be enclosed in braces. If parameter is * or @, 
then all the positional parameters, starting with $1, are substituted 
(separated by a field separator character). If an array identifier 
with subscript * or @ is used, then the value for each of the ele- 
ments is substituted (separated by a field separator character). 
%{^parameter) 

If parameter is * or @, the number of positional parameters is sub- 
stituted. Otherwise, the length of the value of the parameter is 
substituted. 

%{^identifier{^]} 

The number of elements in the array identifier is substituted. 
%{parameter : -word) 

If parameter is set and is non-null then substitute its value; other- 
wise substitute word. 

^{parameter : =word] 

If parameter is not set or is null then set it to word; the value of 
the parameter is then substituted. Positional parameters may not 
be assigned to in this way. 

%{parameter:lword) 

If parameter is set and is non-null then substitute its value; other- 
wise, print word and exit from the shell. If word is omitted then a 
standard message is printed. 

%{parameter : +word} 

\ If parameter is set and is non-null then substitute word; otherwise 

substitute nothing. 

%{parameter#pattern } 

${parameterMpattern } 

If the Shell pattern matches the beginning of the value of parame- 
ter, then the value of this substitution is the value of the parameter 
with the matched portion deleted; otherwise the value of this 
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parameter is substituted. In the first form the smallest matching 
pattern is deleted and in the second form the largest matching pat- 
tern is deleted. 

^{parameter %pattern } 

%{parameter % %pattern } 

If the Shell pattern matches the end of the value of parameter, 
then the value of this substitution is the value of the parameter 
with the matched part deleted; otherwise substitute the value of 
parameter. In the first form the smallest matching pattern is 
deleted and in the second form the largest matching pattern is 
deleted. 

In the above, word is not evaluated unless it is to be used as the substi- 
tuted string, so that, in the following example, pwd is executed only if 
d is not set oris null: 

echo ${d:-$(pwd)} 

If the colon ( : ) is omitted from the above expressions, then the shell 
only checks whether parameter is set or not. 

The following parameters are automatically set by the shell: 

# The number of positional parameters in decimal. 

- Flags supplied to the shell on invocation or by the set com- 
mand. 

? The decimal value returned by the last executed command. 

$ The process number of this shell. 

__ Initially, the value _ is an absolute pathname of the shell or 
script being executed as passed in the environment. Subse- 
quently it is assigned the last argument of the previous com- 
mand. This parameter is not set for commands which are asyn- 
chronous. This parameter is also used to hold the name of the 
matching MAIL file when checking for mail. 

! The process number of the last background command invoked. 
ERRNO 

The value of errno as set by the most recently failed system 
call. This value is system dependent and is intended for debug- 
ging purposes. 

LINENO 

The line number of the current line within the script or function 
being executed. 

OLDPWD 

The previous working directory set by the cd command. 

OPTARG 

The value of the last option argument processed by the getopts 
special command. 

OPTIND 

The index of the last option argument processed by the getopts 
special command. 
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PPID 

The process number of the parent of the shell. 

PWD 

The present working directory set by the cd command. 

RANDOM 

Each time this parameter is referenced, a random integer, uni- 
formly distributed between 0 and 32767, is generated. The 
sequence of random numbers can be initialized by assigning a 
numeric value to RANDOM. 

REPLY 

This parameter is set by the select statement and by the read 
special command when no arguments are supplied. 

SECONDS 

Each time this parameter is referenced, the number of seconds 
since shell invocation is returned. If this parameter is assigned 
a value, then the value returned upon reference will be the 
value that was assigned plus the number of seconds since the 
assignment. 

The following parameters are used by the shell: 

CDPATH 

The search path for the cd command. 

COLUMNS 

If this variable is set, the value is used to define the width of the 
edit window for the shell edit modes and for printing select 
lists. 

EDITOR 

If the value of this variable ends in emacs , gmacs , or vi and the 
VISUAL variable is not set, then the corresponding option (see 
Special Command set below) will be turned on. 

ENV 

If this parameter is set, then parameter substitution is per- 
formed on the value to generate the pathname of the script that 
will be executed when the shell is invoked. (See Invocation 
below.) This file is typically used for alias and function 
definitions. 

FCEDIT 

The default editor name for the fc command. 

FPATH 

The search path for function definitions. This path is searched 
when a function with the -u attribute is referenced and when a 
command is not found. If an executable file is found, then it is 
read and executed in the current environment. 

IFS 

Internal field separators, normally space, tab, and new-line that 
is used to separate command words which result from com- 
mand or parameter substitution and for separating words with 
the special command read. The first character of the IFS 
parameter is used to separate arguments for the ”$*" substitu- 
tion (See Quoting below). 
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HISTFILE 

If this parameter is set when the shell is invoked, then the value 
is the pathname of the file that will be used to store the com- 
mand history. (See Command re-entry below.) 

HISTSIZE 

If this parameter is set when the shell is invoked, then the num- 
ber of previously entered commands that are accessible by this 
shell will be greater than or equal to this number. The default 
is 128. 

HOME 

The default argument (home directory) for the cd command. 
LINES 

If this variable is set, the value is used to determine the column 
length for printing select lists. Select lists will print vertically 
until about two-thirds of LINES lines are filled. 

MAIL 

If this parameter is set to the name of a mail file and the MAIL- 
PATH parameter is not set, then the shell informs the user of 
arrival of mail in the specified file. 

MAILCHECK 

This variable specifies how often (in seconds) the shell will 
check for changes in the modification time of any of the files 
specified by the MAILPATH or MAIL parameters. The default 
value is 600 seconds. When the time has elapsed the shell will 
check before issuing the next prompt. 

MAILPATH 

A colon ( : ) separated list of file names. If this parameter is set 
then the shell informs the user of any modifications to the 
specified files that have occurred within the last MAILCHECK 
seconds. Each file name can be followed by a ? and a message 
that will be printed. The message will undergo parameter sub- 
stitution with the parameter, $_ defined as the name of the file 
that has changed. The default message is you have mail in $_, 
PATH 

The search path for commands (see Execution below). The 
user may not change PATH if executing under rksh (except in 
.profile ). 

PSl 

The value of this parameter is expanded for parameter substitu- 
tion to define the primary prompt string which by default is “$ 
The character ! in the primary prompt string is replaced by 
the command number (see Command Re-entry below). 

PS2 

Secondary prompt string, by default “> 

PS3 

Selection prompt string used within a select loop, by default 
“#? 

PS4 

The value of this parameter is expanded for parameter substitu- 
tion and precedes each line of an execution trace. If omitted, 
the execution trace prompt is “+ 



March 1 9, 1 990 



KSH-9 




KSH (C) 



KSH (C) 



SHELL 

The pathname of the shell is kept in the environment. At invo- 
cation, if the basename of this variable matches the pattern 
*r*sh, then the shell becomes restricted. 

TMOUT 

If set to a value greater than zero, the shell will terminate if a 
command is not entered within the prescribed number of 
seconds after issuing the PSl prompt. (Note that the shell can 
be compiled with a maximum bound for this value which can- 
not be exceeded.) 

VISUAL 

If the value of this variable ends in emacs.gmacs, or vz then the 
corresponding option (see Special Command set below) will be 
turned on. 

The shell gives default values to PATH, PSl, PS2, MAILCHECK, 
TMOUT and IFS, while HOME, SHELL ENV and MAIL are not set at 
all by the shell (although HOME is set by login(M)). On some sys- 
tems MAIL and SHELL are also set by login(M)). 



Blank Interpretation 

After parameter and command substitution, the results of substitutions 
are scanned for the field separator characters ( those found in IFS ) and 
split into distinct arguments where such characters are found. Explicit 
null arguments (" " or ") are retained. Implicit null arguments (those 
resulting from parameters that have no values) are removed. 



File Name Generation 

Following substitution, each command word is scanned for the char- 
acters ♦, ?, and [ unless the -f option has been set. If one of these 
characters appears then the word is regarded as a pattern . The word is 
replaced with lexicographically sorted file names that match the pat- 
tern. If no file name is found that matches the pattern, then the word is 
left unchanged. When a pattern is used for file name generation, the 
character . at the start of a file name or immediately following a /, as 
well as the character / itself, must be matched explicitly. In other 
instances of pattern matching the / and . are not treated specially. 

* Matches any string, including the null string. 

? Matches any single character. 

[...] 

Matches any one of the enclosed characters. A pair of charac- 
ters separated by - matches any character lexically between the 
pair, inclusive. If the first character following the opening "[ ” 
is a ”! " then any character not enclosed is matched. A - can be 
included in the character set by putting it as the first or last 
character. 



March 19, 1990 



KSH-10 




KSH (C) 



KSH (C) 



A pattern-list is a list of one or more patterns separated by each other 
with a I . Composite patterns can be formed with one or more of the 
following: 

l(pattern-list) 

Optionally matches any one of the given patterns. 

"^(pattern-list) 

Matches zero or more occurrences of the given patterns. 
'^(pattern-list) 

Matches one or more occurrences of the given patterns. 
@(pattern-list ) 

Matches exactly one of the given patterns. 

\(pattern-list) 

Matches anything, except one of the given patterns. 



Quoting 

Each of the metacharacters listed above (See Definitions above) has a 
special meaning to the shell and causes termination of a word unless 
quoted. A character may be quoted (i.e., made to stand for itselO by 
preceding it with a \. The pair \new-line is ignored. All characters 
enclosed between a pair of single quote marks ("), are quoted. A sin- 
gle quote cannot appear within single quotes. Inside double quote 
marks (” ”), parameter and command substitution occurs and \ quotes 
the characters \, ”, and $. The meaning of $* and $@ is identical 

when not quoted or when used as a parameter assignment value or as a 
file name. However, when used as a command argument, ”$♦” is 
equivalent to where d is the first character of the IFS 

parameter, whereas ”$@” is equivalent to ”$1” ”$2” Inside 

grave quote marks (^ ^) \ quotes the characters \, and $. If the grave 
quotes occur within double quotes then \ also quotes the character ”. 

The special meaning of reserved words or aliases can be removed by 
quoting any character of the reserved word. The recognition of func- 
tion names or special command names listed below cannot be altered 
by quoting them. 



Arithmetic Evaluation 

An ability to perform integer arithmetic is provided with the special 
command let. Evaluations are performed using long arithmetic. Con- 
stants are of the form [hase#]n where base is a decimal number 
between two and thirty-six representing the arithmetic base and n is a 
number in that base. If base is omitted then base 10 is used. 

An arithmetic expression uses the same syntax, precedence, and asso- 
ciativity of expression of the C language. All the integral operators, 
other than ++, ?:, and , are supported. Named parameters can be 

referenced by name within an arithmetic expression without using the 
parameter substitution syntax. When a named parameter is refer- 
enced, its value is evaluated as an arithmetic expression. 
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An internal integer representation of a named parameter can be 
specified with the -i option of the typeset special command. Arith- 
metic evaluation is performed on the value of each assignment to a 
named parameter with the -i attribute. If you do not specify an arith- 
metic base, the first assignment to the parameter determines the arith- 
metic base. This base is used when parameter substitution occurs. 

Since many of the arithmetic operators require quoting, an alternative 
form of the let command is provided. For any command which begins 
with a ((, all the characters until a matching )) are treated as a quoted 
expression. More precisely, ((. . .)) is equivalent to let ” . . 



Prompting 

When used interactively, the shell prompts with the value of PSl 
before reading a command. If at any time a new-line is typed and 
further input is needed to complete a command, then the secondary 
prompt (i.e., the value of PS2) is issued. 



Conditional Expressions 

A conditional expression is used with the [[ compound command to 
test attributes of files and to compare strings. Word splitting and file 
name generation are not performed on the words between [[ and ]]. 
Each expression can be constructed from one or more of the following 
unary or binary expressions: 

•afile 

True, if file exists. 

-bfile 

True, if file exists and is a block special file. 

-cfde 

True, if file exists and is a character special file. 

-dfile 

True, if file exists and is a directory. 

4 file 

True, if file exists and is an ordinary file. 

•gfile 

True, if file exists and is has its setgid bit set. 

-kfile 

True, if file exists and is has its sticky bit set. 

-n string 

True, if length of string is non-zero. 

-o option 

True, if option named option is on. 

-pfile 

True, if file exists and is a fifo special file or a pipe. 

-rfile 

True, if file exists and is readable by current process. 
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-sfile 

True, if file exists and has size greater than zero. 

-t fildes 

True, if file descriptor number fildes is open and associated with a 
terminal device. 

-ufile 

True, if file exists and is has its setuid bit set. 

-w file 

True, if file exists and is writable by current process. 

•\file 

True, ii file exists and is executable by current process. If file 
exists and is a directory, then the current process has permission to 
search in the directory. 

-z string 

True, if length of string is zero. 

•Ofile 

True, if file exists and is owned by the effective user id of this pro- 
cess. 

^Gfile 

True, if file exists and its group matches the effective group id of 
this process. 
filel -nt file! 

True, if filel exists and is newer than filel . 
filel -oi file! 

True, if filel exists and is older than filel . 
filel filel 

True, if filel and filel exist and refer to the same file. 
string = pattern 

True, if string matches pattern . 
string != pattern 

True, if string does not match pattern . 
stringl < stringl 

True, if stringl comes before stringl based on ASCII value of their 
characters. 
stringl > stringl 

True, if stringl comes after stringl based on ASCII value of their 
characters. 
expl -eq expl 

True, if expl is equal to expl. 
expl -ne expl 

True, if expl is not equal to expl. 
expl -It expl 

True, if expl is less than expl. 
expl -gt expl 

True, if expl is greater than expl. 
expl -le expl 

True, if expl is less than or equal to expl. 
expl -ge expl 

True, if expl is greater than or equal to expl. 
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In each of the above expressions, if file is of the form /dev/fd/«, where 
n is an integer, then the test applied to the open file whose descriptor 
number is n. 

A compound expression can be constructed from these primitives by 
using any of the following, listed in decreasing order of precedence. 
{expression) 

True, if expression is true. Used to group expressions. 

! expression 

True if expression is false. 
expression! && expression! 

True, if expression! and expression! are both true. 
expression! \ \ expression! 

True, if either expression! or expression! is true. 



Spelling Checker 

By default, the shell checks spelling whenever you use cd to change 
directories. For example, if you change to a different directory using 
cd and misspell the directory name, the shell responds with an alterna- 
tive spelling of an existing directory. Enter “y” and press RETURN 
(or just press RETURN) to change to the offered directory. If the of- 
fered spelling is incorrect, enter “n”, then retype the command line. 
In this example the ksh response is boldfaced: 

# cd /usr/spol/uucp 
/usr/spool/uucp? y 
ok 

The spell check feature is controlled by the CDSPELL environment 
variable. The default value of CDSPELL is set to the string “cdspelP ’ 
whenever a ksh session is run. A user can change it to any value, 
including the null string, but the value is immaterial, if CDSPELL is 
set to any value, the spell check feature is engaged. 

To disable the spelling checker, enter the following at the ksh prompt : 
®.DE 

When the user does a set at the ksh prompt, 

CDSPELL is not listed if the unset was successful. 



Input/Output 

Before a command is executed, its input and output may be redirected 
using a special notation interpreted by the shell. The following may 
appear anywhere in a simple-command or may precede or follow a 
command and are not passed on to the invoked command. Command 
and parameter substitution occurs before word or digit is used except 
as noted below. File name generation occurs only if the pattern 
matches a single file and blank interpretation is not performed. 



March 19, 1990 



KSH-14 




KSH (C) 



KSH (C) 



<word Use file word as standard input (file descriptor 0). 

>word Use file word as standard output (file descriptor 1). 

If the file does not exist then it is created. If the file 
exists, and the noclobber option is on, this causes an 
error; otherwise, it is truncated to zero length. 

>\word Sames as >, except that it overrides the noclobber 

option. 

»word Use file word as standard output. If the file exists 

then output is appended to it (by first seeking to the 
end-of-file); otherwise, the file is created. 

oword Open file word for reading and writing as standard 

input. 

«[ - ]word The shell input is read up to a line that is the same as 
word, or to an end-of-file. No parameter substitu- 
tion, command substitution or file name generation is 
performed on word. The resulting document, called 
a here-docLiment , becomes the standard input. If any 
character of word is quoted, then no interpretation is 
placed upon the characters of the document; other- 
wise, parameter and command substitution occurs, 
\new-line is ignored, and \ must be used to quote the 
characters \, $, ^ , and the first character of word. If - 
is appended to «, then all leading tabs are stripped 
from word and from the document. 

<&digit The standard input is duplicated from file descriptor 

digit (see dup(S)). Similarly for the standard output 
using >& digit. 

<&- The standard input is closed. Similarly for the stan- 

dard output using >&-. 

<&p The input from the co-process is moved to standard 

input. 

>&p The output to the co-process is moved to standard 

output. 

If one of the above is preceded by a digit, then the file descriptor num- 
ber referred to is that specified by the digit (instead of the default 0 or 

1). For example: 

means file descriptor 2 is to be opened for writing as a duplicate of file 

descriptor 1. 
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The order in which redirections are specified is significant. The shell 
evaluates each redirection in terms of the (file descriptor .file) associ- 
ation at the time of evaluation. For example: 

... \>fname 2>&1 

first associates file descriptor 1 with fAtfname . It then associates file 
descriptor 2 with the file associated with file descriptor 1 (i.e. /name ). 
If the order of redirections were reversed, file descriptor 2 would be 
associated with the terminal (assuming file descriptor 1 had been) and 
then file descriptor 1 would be associated with file fname . 

If a command is followed by & and job control is not active, then the 
default standard input for the command is the empty file /dev/null. 
Otherwise, the environment for the execution of a command contains 
the file descriptors of the invoking shell as modified by input/output 
specifications. 



Environment 

The environment (see environ(M)) is a list of name-value pairs that is 
passed to an executed program in the same way as a normal argument 
list. The names must be identifiers and the values are character 
strings. The shell interacts with the environment in several ways. On 
invocation, the shell scans the environment and creates a parameter 
for each name found, giving it the corresponding value and marking it 
export . Executed commands inherit the environment. If the user 
modifies the values of these parameters or creates new ones, using the 
export or typeset -x commands they become part of the environment. 
The environment seen by any executed command is thus composed of 
any name-value pairs originally inherited by the shell, whose values 
may be modified by the current shell, plus any additions which must 
be noted in export or typeset -x commands. 

The environment for any simple -command or function may be aug- 
mented by prefixing it with one or more parameter assignments. A 
parameter assignment argument is a word of the form 
identifier-value. Thus: 

TERM=450 cmd args and 

(export TERM; TERM=450; cmd args) 

are equivalent (as far as the above execution of cmd is concerned). 

If the -k flag is set, all parameter assignment arguments are placed in 
the environment, even if they occur after the command name. The fol- 
lowing first prints a=b c and then c: 

echo a=b c 
set -k 
echo a=b c 
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This feature is intended for use with scripts written for early versions 
of the shell and its use in new scripts is strongly discouraged. It is 
likely to disappear someday. 

Functions 

The function reserved word, described in the Commands section 
above, is used to define shell functions. Shell functions are read in 
and stored internally. Alias names are resolved when the function is 
read. Functions are executed like commands with the arguments 
passed as positional parameters. (See Execution below). 

Functions execute in the same process as the caller and share all files 
and present working directory with the caller. Traps caught by the 
caller are reset to their default action inside the function. A trap con- 
dition that is not caught or ignored by the function causes the function 
to terminate and the condition to be passed on to the caller. A trap on 
EXIT set inside a function is executed after the function completes in 
the environment of the caller. Ordinarily, variables are shared 
between the calling program and the function. However, the typeset 
special command used within a function defines local variables whose 
scope includes the current function and all functions it calls. 

The special command return is used to return from function calls. 
Errors within functions return control to the caller. 

Function identifiers can be listed with the -f or +f option of the typeset 
special command. The text of functions will also be listed with -f. 
Function can be undefined with the -f option of the unset special com- 
mand. 

Ordinarily, functions are unset when the shell executes a shell script. 
The -xf option of the typeset command allows a function to be 
exported to scripts that are executed without a separate invocation of 
the shell. Functions that need to be defined across separate invoca- 
tions of the shell should be specified in the ENV file with the -xf 
option of typeset 

Jobs 

If the monitor option of the set command is turned on, an interactive 
shell associates a job with each pipeline. It keeps a table of current 
jobs, printed by the jobs command, and assigns them small integer 
numbers. When a job is started asynchronously with &, the shell 
prints a line which looks like: 

[1] 1234 

indicating that the job which was started asynchronously was job 
number 1 and had one (top-level) process, whose process id was 1234. 
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This paragraph and the next require features that are not in all versions 
of the UNIX operating system and may not apply. If you are running a 
job and wish to do something else you may hit the key "Z (control-Z) 
which sends a STOP signal to the current job. The shell will then nor- 
mally indicate that the job has been ‘Stopped’, and print another 
prompt. You can then manipulate the state of this job, putting it in the 
background with the bg command, or run some other commands and 
then eventually bring the job back into the foreground with the fore- 
ground command fg. A "Z takes effect immediately and is like an 
interrupt in that pending output and unread input are discarded when it 
is typed. 

A job being run in the background will stop if it tries to read from the 
terminal. Background jobs are normally allowed to produce output, 
but this can be disabled by giving the command “stty tostop”. If you 
set this tty option, then background jobs will stop when they try to 
produce output like they do when they try to read input. 

There are several ways to refer to jobs in the shell. A job can be 
referred to by the process id of any process of the job or by one of the 
following: 

% number 

The job with the given number. 

% string 

Any job whose command line begins with string . 
string 

Any job whose command line contains string, 

%% 

Current job. 

%+ 

Equivalent to %%. 

%- 

Previous job. 

This shell learns immediately whenever a process changes state. It 
normally informs you whenever a job becomes blocked so that no 
further progress is possible, but only just before it prints a prompt. 
This is done so that it does not otherwise disturb your work. 

When the monitor mode is on, each background job that completes 
triggers any trap set for CHLD. 

When you try to leave the shell while jobs are running or stopped, you 
will be warned that ‘You have stopped(running) jobs.’ You may use 
the Jobs command to see what they are. If you do this or immediately 
try to exit again, the shell will not warn you a second time, and the 
stopped jobs will be terminated. 
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Signals 

The INT and QUIT signals for an invoked command are ignored if the 
command is followed by & and job monitor option is not active. Oth- 
erwise, signals have the values inherited by the shell from its parent 
(but see also the trap command below). 



Execution 

Each time a command is executed, the above substitutions are carried 
out. If the command name matches one of the Special Commands 
listed below, it is executed within the current shell process. Next, the 
command name is checked to see if it matches one of the user defined 
functions. If it does, the positional parameters are saved and then 
reset to the arguments of the function call. When the function com- 
pletes or issues a return, the positional parameter list is restored and 
any trap set on EXIT within the function is executed. The value of a 
function is the value of the last command executed. A function is also 
executed in the current shell process. If a command name is not a spe- 
cial command or a user function , a process is created and an 

attempt is made to execute the command via exec (S). 

The shell parameter PATH defines the search path for the directory 
containing the command. Alternative directory names are separated 
by a colon (:). The default path is /bin:/usr/bin: (specifying /bin, 
/usr/bin, and the current directory in that order). The current direc- 
tory can be specified by two or more adjacent colons, or by a colon at 
the beginning or end of the path list. If the command name contains a 
/ then the search path is not used. Otherwise, each directory in the 
path is searched for an executable file. If the file has execute permis- 
sion but is not a directory or an a.out file, it is assumed to be a file 
containing shell commands. A sub-shell is spawned to read it. All 
non-exported aliases, functions, and named parameters are removed in 
this case. If the shell command file doesn’t have read permission, or if 
the setuid and/or setgid bits are set on the file, then the shell executes 
an agent whose job it is to set up the permissions and execute the shell 
with the shell command file passed down as an open file. A 
parenthesized command is executed in a sub-shell without removing 
non-exported quantities. 



Command Re-entry 

The text of the last HISTSIZE (default 128) commands entered from a 
terminal device is saved in a history file. The file $HOME/.sh__history 
is used if the HISTFILE variable is not set or is not writable. A shell 
can access the commands of all interactive shells which use the same 
named HISTFILE. The special command fc is used to list or edit a 
portion of this file. The portion of the file to be edited or listed can be 
selected by number or by giving the first character or characters of the 
command. A single command or range of commands can be specified. 
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If you do not specify an editor program as an argument to fc then the 
value of the parameter FCEDIT is used. If FCEDIT is not defined then 
/bin/ed is used. The edited command(s) is printed and re-executed 
upon leaving the editor. The editor name - is used to skip the editing 
phase and to re-execute the command. In this case a substitution 
parameter of the form old-new can be used to modify the command 
before execution. For example, if r is aliased to Tc -e then typing ‘r 
bad=good c’ will re-execute the most recent command which starts 
with the letter c, replacing the first occurrence of the string bad with 
the string good. 

In-line Editing Options 

Normally, each command line entered from a terminal device is sim- 
ply typed followed by a new-line (‘RETURN’ or ‘LINE FEED’). If 
either the emacs, ginacs, or vi option is active, the user can edit the 
command line. To be in either of these edit modes set the correspond- 
ing option. An editing option is automatically selected each time the 
VISUAL or EDITOR variable is assigned a value ending in either of 
these option names. 

The editing features require that the user’s terminal accept ‘RETURN’ 
as carriage return without line feed and that a space (‘ ’) must 
overwrite the current character on the screen. ADM terminal users 
should set the "space - advance" switch to ‘space’. Hewlett-Packard 
series 2621 terminal users should set the straps to ‘bcGHxZ etX’. 

The editing modes implement a concept where the user is looking 
through a window at the current line. The window width is the value 
of COLUMNS if it is defined, otherwise 80. If the line is longer than 
the window width minus two, a mark is displayed at the end of the 
window to notify the user. As the cursor moves and reaches the win- 
dow boundaries the window will be centered about the cursor. The 
mark is a > (<, *) if the line extends on the right (left, both) side(s) of 
the window. 

The search commands in each edit mode provide access to the history 
file. Only strings are matched, not patterns, although a leading " in the 
string restricts the match to begin at the first character in the line. 

Emacs Editing Mode 

This mode is entered by enabling either the emacs or gmacs option. 
The only difference between these two modes is the way they handle 
"T. To edit, the user moves the cursor to the point needing correction 
and then inserts or deletes characters or words as needed. All the edit- 
ing commands are control characters or escape sequences. The nota- 
tion for control characters is caret ( " ) followed by the character. For 
example, ''F is the notation for control F. This is entered by depress- 
ing ‘f’ while holding down the ‘CTRL’ (control) key. The ‘SHIFT’ 
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key is depressed. (The notation "? indicates the DEL (delete) 
key.) 

The notation for escape sequences is M- followed by a character. For 
example, M-f (pronounced Meta f) is entered by depressing ESC (ascii 
033) followed by T’. (M-F would be the notation for ESC followed by 
‘SHIFT’ (capital) ‘F’.) 

All edit commands operate from any place on the line (not just at the 
beginning). Neither the "RETURN" nor the "LINE FEED" key is 
entered after edit commands except when noted. 

"'F Move cursor forward (right) one character. 

M-f Move cursor forward one word. (The emacs editor’s idea 

of a word is a string of characters consisting of only 
letters, digits and underscores.) 

"B Move cursor backward (left) one character. 

M-b Move cursor backward one word. 

"A Move cursor to start of line. 

"E Move cursor to end of line. 

^]char Move cursor forward to character char on current line. 
M-"'\char Move cursor back to character char on current line. 

"X"X Interchange the cursor and mark. 

erase (User defined erase character as defined by the stty(C) 
command, usually "H or#.) Delete previous character. 

"D Delete current character. 

M-d Delete current word. 

M-"H (Meta-backspace) Delete previous word. 

M-h Delete previous word. 

M-"? (Meta-DEL) Delete previous word (if your interrupt char- 
acter is "? (DEL, the default) then this command will not 
work). 

"T Transpose current character with next character in emacs 

mode. Transpose two previous characters in gmacs mode. 
"C Capitalize current character. 

M-c Capitalize current word. 

M-1 Change the current word to lower case. 

"'K Delete from the cursor to the end of the line. If preceded 

by a numerical parameter whose value is less than the 
current cursor position, then delete from given position up 
to the cursor. If preceded by a numerical parameter 
whose value is greater than the current cursor position, 
then delete from cursor up to given cursor position. 

Kill from the cursor to the mark. 

M-p Push the region from the cursor to the mark on the stack. 

kill (User defined kill character as defined by the stty com- 

mand, usually "G or @.) Kill the entire current line. If 
two kill characters are entered in succession, all kill char- 
acters from then on cause a line feed (useful when using 
paper terminals). 
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"Y Restore last item removed from line. (Yank item back to 

the line.) 

X Line feed and print current line. 

(Null character) Set mark. 

M-space (Meta space) Set mark. 

"J (New line) Execute the current line. 

"M (Return) Execute the current line. 

eof End-of-file character, normally "D, is processed as an 

End-of-file only if the current line is null. 

"P Fetch previous command. Each time "P is entered the 

previous command back in time is accessed. Moves back 
one line when not on the first line of a multi-line com- 
mand. 

M-< Fetch the least recent (oldest) history line. 

M-> Fetch the most recent (youngest) history line. 

"N Fetch next command line. Each time "N is entered the 

next command line forward in time is accessed. 

"'Rstring Reverse search history for a previous command line con- 
taining string . If a parameter of zero is given, the search 
is forward. String is terminated by a "RETURN" or 
"NEW LINE". If string is preceded by a ", the matched 
line must begin with string . If string is omitted, then the 
next command line containing the most recent string is 
accessed. In this case a parameter of zero reverses the 
direction of the search. 

"O Operate - Execute the current line and fetch the next line 

relative to current line from the history file. 

M-digits (Escape) Define numeric parameter, the digits are taken 
as a parameter to the next command. The commands that 
accept a parameter are "F, "B, erase, "C, "D, "K, "R, "P, 
"N, 1, M-., M-"], M- , M-b, M-c, M-d, M-f, M-h M-l and 
M-"H. 

Mdetter Soft-key - Your alias list is searched for an alias by the 
name Jetter and if an alias of this name is defined, its 
value will be inserted on the input queue. The letter must 
not be one of the above meta-functions. M-]letter Soft- 
key - Your alias list is searched for an alias by the name 

letter and if an alias of this name is defined, its value 

will be inserted on the input queue. The can be used to 
program functions keys on many terminals. 

M-. The last word of the previous command is inserted on the 

line. If preceded by a numeric parameter, the value of 
this parameter determines which word to insert rather 
than the last word. 

M-_ Same as M-.. 

M-* Attempt file name generation on the current word. An 

asterisk is appended if the word doesn’t match any file or 
contain any special pattern characters. 
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File name completion. Replaces the current word with 
the longest common prefix of all filenames matching the 
current word with an asterisk appended. If the match is 
unique, a / is appended if the file is a directory and a space 
is appended if the file is not a directory. 

List files matching current word pattern if an asterisk 
were appended. 

Multiply piu’ameter of next command by 4. 

Escape next character. Editing characters, the user’s 
erase, kill and interrupt (normally "?) characters may be 
entered in a command line or in a search string if pre- 
ceded by a \. The \ removes the next character’s editing 
features (if any). 

Display version of the shell. 

Insert a # at the beginning of the line and execute it. This 
causes a comment to be inserted in the history file. 

Vi Editing Mode 

There are two typing modes. Initially, when you enter a command you 
are in the input mode. To edit, the user enters control mode by typing 
ESC ( 033 ) and moves the cursor to the point needing correction and 
then inserts or deletes characters or words as needed. Most control 
commands accept an optional repeat count prior to the command. 
When in vi mode on most systems, canonical processing is initially 
enabled and the command will be echoed again if the speed is 1200 
baud or greater and it contains any control characters or less than one 
second has elapsed since the prompt was printed. The ESC character 
terminates canonical processing for the remainder of the command 
and the user can then modify the command line. This scheme has the 
advantages of canonical processing with the type-ahead echoing of 
raw mode. 

If the option viraw is also set, the terminal will always have canonical 
processing disabled. This mode is implicit for systems that do not 
support two alternate end of line delimiters, and may be helpful for 
certain terminals. 
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M-ESC 

M-= 
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\ 

W 

M-# 



Input Edit Commands 

By default the editor is in input mode. 

erase (User defined erase character as defined by the stty 
command, usually "H or#.) Delete previous character. 

"W Delete the previous blank separated word. 

Terminate the shell. 

W Escape next character. Editing characters, the user’s 

erase or kill characters may be entered in a command 
line or in a search string if preceded by a "V. The "V 
removes the next character’s editing features (if any). 

\ Escape the next erase or kill character. ^ 
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Motion Edit Commands 

These commands will move the cursor. 

[count]\ Cursor forward (right) one chtiracter. 

[count]w Cursor forward one alpha-numeric word. 

[count]W Cursor to the beginning of the next word that follows a 
blank. 

[count]e Cursor to end of word. 

[count \E Cursor to end of the current blank delimited word. 
[count]h Cursor backward (left) one character. 

[count]b Cursor backward one word. 

[count]B Cursor to preceding blank separated word. 

[count] I Cursor to column count. 

[count]^c Find the next character c in the current line. 

[count]¥c Find the previous character c in the current line. 
[count]ic Equivalent to f followed by h. 

[count]Tc Equivalent to F followed by I. 

[count]\ Repeats count times, the last single character find 
command, f, F, t, or T. 

[count]^ Reverses the last single character find command count 
times. 

0 Cursor to start of line. 

Cursor to first non-blank character in line. 

$ Cursor to end of line. 

Search Edit Commands 

These commands access your command history. 

[count]k Fetch previous command. Each time k is entered the 
previous command back in time is accessed. 

[count]- Equivalent to k. 

[count]] Fetch next command. Each time j is entered the next 

command forward in time is accessed. 

[count]+ Equivalent to j. 

[count]G The command number count is fetched. The default is 
the least recent history command. 

Istring Search backward through history for a previous com- 
mand containing string. String is terminated by a 
"RETURN” or "NEW LINE". If string is preceded by 
a ", the matched line must begin with string . If string 
is null the previous string will be used. 

Istring Same as / except that search will be in the forward 
direction. 

n Search for next match of the last pattern to / or ? com- 

mands. 

N Search for next match of the last pattern to / or ?, but 

in reverse direction. Search history for the string 
entered by the previous / command. 



March 19, 1990 



KSH-24 




KSH (C) 



KSH (C) 



Text Modification Edit Commands 
These commands will modify the line. 

a Enter input mode and enter text after the current char- 

acter. 

A Append text to the end of the line. Equivalent to $a. 

[count]cmotion 

c[count]motion 

Delete current character through the character that 
motion would move the cursor to and enter input 
mode. If motion is c, the entire line will be deleted 
and input mode entered. 

C Delete the current character through the end of line 

and enter input mode. Equivalent to c$. 

S Equivalent to cc. 

D Delete the current character through the end of line. 

Equivalent to d$. 

[count\(lmotion 

d[count]motion 

Delete current character through the character that 
motion would move to. If motion is d , the entire line 
will be deleted. 

i Enter input mode and insert text before the current 

character. 

I Insert text before the beginning of the line. Equivalent 

to Oi. 

[count\V Place the previous text modification before the cursor. 
[count]^ Place the previous text modification after the cursor. 

R Enter input mode and replace characters on the screen 

with characters you type overlay fashion. 

[count\vc Replace the count character(s) starting at the current 
cursor position with c, and advance the cursor. 

[count\\ Delete current character. 

[count]X Delete preceding character. 

[count]. Repeat the previous text modification command. 

[count]- Invert the case of the count character(s) starting at the 

current cursor position and advance the cursor. 

[count]_ Causes the count word of the previous command to be 
appended and input mode entered. The last word is 
used if count is omitted. 

* Causes an * to be appended to the current word and 

file name generation attempted. If no match is found, 
it rings the bell. Otherwise, the word is replaced by 
the matching pattern and input mode is entered. 

\ Filename completion. Replaces the current word with 

the longest common prefix of all filenames matching 
the current word with an asterisk appended. If the 
match is unique, a / is appended if the file is a direc- 
tory and a space is appended if the file is not a direc- 
tory. 
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Other Edit Commands 

Miscellaneous commands. 

[country motion 
y[count]motion 

Yank current character through character that motion 
would move the cursor to and puts them into the delete 
buffer. The text and cursor are unchanged. 

Yanks from current position to end of line. Equivalent 
to y$. 

Undo the last text modifying command. 

Undo all the text modifying commands performed on 
the line. 

Returns the command fc -e 

${VISUAL:-${EDITOR:-vi}} count in the input buffer. 
If count is omitted, then the current line is used. 

Line feed and print current line. Has effect only in 
control mode. 

(New line) Execute the current line, regardless of 
mode. 

(Return) Execute the current line, regardless of mode. 
Sends the line after inserting a # in front of the line. 
Useful for causing the current line to be inserted in the 
history without being executed. 

List the file names that match the current word if an 
asterisk were appended it. 

Your alias list is searched for an alias by the name 
Jetter and if an alias of this name is defined, its value 
will be inserted on the input queue for processing. 



Special Commands. 

The following simple-commands are executed in the shell process. 
Input/Output redirection is permitted. Unless otherwise indicated, the 
output is written on file descriptor 1 and the exit status, when there is 
no syntax error, is zero. Commands that are preceded by one or two t 
are treated specially in the following ways: 

1. Parameter assignment lists preceding the command remain in 
effect when the command completes. 

2. I/O redirections are processed after parameter assignments. 

3. Errors cause a script that contains them to abort. 

4. Words, following a command preceded by tt that are in the format 

of a parameter assignment, are expanded with the same rules as a 
parameter assignment. This means that tilde substitution is per- 
formed after the = sign and word splitting and file name generation 
are not performed. ^ 



Y 

u 

U 

[count\\ 

L 

# 

@letter 
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-fil arg ...] 

The command only expands parameters. 

.file [ arg ... ] 

Read the complete file then execute the commands. The com- 
mands are executed in the current Shell environment. The search 
path specified by PATH is used to find the directory containing . 
If any arguments arg are given, they become the positional param- 
eters. Otherwise the positional parameters are unchanged. The 
exit status is the exit status of the last command executed. 

tt alias [ -tx ] [ name[ =value ] ] ... 

Alias with no arguments prints the list of aliases in the form 
name=value on standard output. An alias is defined for each name 
whose value is given. A trailing space in value causes the next 
word to be checked for alias substitution. The -t flag is used to set 
and list tracked aliases. The value of a tracked alias is the full 
pathname corresponding to the given name. The value becomes 
undefined when the value of PATH is reset but the aliases remained 
tracked. Without the -t flag, for each name in the argument list for 
which no value is given, the name and value of the alias is printed. 
The -X flag is used to set or print exported aliases. An exported 
alias is defined for scripts invoked by name. The exit status is 
non-zero if a name is given, but no value, for which no alias has 
been defined. 

hg[ job...] 

This command is only on systems that support job control. Puts 
each specified Job into the background. The current job is put in 
the background if job is not specified. See Jobs for a description 
of the format of job . 

t break [ n ] 

Exit from the enclosing for while until or select loop, if any. If n 
is specified then break n levels. 

t continue [ n ] 

Resume the next iteration of the enclosing for while until or 
select loop. If n is specified then resume at the «-th enclosing 
loop. 

cd [ arg ] 
cd old new 

This command can be in either of two forms. In the first form it 
changes the current directory to arg. If arg is - the directory is 
changed to the previous directory. The shell parameter HOME is 
the default arg. The parameter PWD is set to the current directory. 
The shell parameter CDPATH defines the search path for the direc- 
tory containing arg. Alternative directory names are separated by 
a colon (:). The default path is <null> (specifying the current 
directory). Note that the current directory is specified by a null 
path name, which can appear immediately after the equal sign or 
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between the colon delimiters anywhere else in the path list. If arg 
begins with a / then the search path is not used. Otherwise, each 
directory in the path is searched for^/r^^ 

The second form of cd substitutes the string new for the string old 
in the current directory name, PWD and tries to change to this new 
directory. 

The cd command may not be executed by rksh. 
echo [ arg . . . ] 

See echo(C) for usage and description, 
t eval [ arg . . . J 

The arguments are read as input to the shell and the resulting 
command(s) executed. 

t exec [ arg . . . ] 

If arg is given, the command specified by the arguments is exe- 
cuted in place of this shell without creating a new process. 
Input/output arguments may appear and affect the current process. 
If no arguments are given the effect of this command is to modify 
file descriptors as prescribed by the input/output redirection list. In 
this case, any file descriptor numbers greater than 2 that are opened 
with this mechanism are closed when invoking another program. 

t exit [ n ] 

Causes the shell to exit with the exit status specified by n. If « is 
omitted then the exit status is that of the last command executed. 
An end-of-file will also cause the shell to exit except for a shell 
which has the ignoreeof option (See set below) turned on. 

tt export [ name[ =valiie 1 | . . . 

The given names are marked for automatic export to the environ- 
ment of subsequently-executed commands. 

fc [ -e ename | [ -nlr ] [ first [ last J ] 
fc -e - [ old=new ] [ command \ 

In the first form, a range of commands from first to last is selected 
from the last HISTSIZE commands that were typed at the terminal. 
The arguments first and last may be specified as a number or as a 
string. A string is used to locate the most recent command starting 
with the given string. A negative number is used as an offset to the 
current command number. If the flag -1, is selected, the commands 
are listed on standard output. Otherwise, the editor program 
ename is invoked on a file containing these keyboard commands. 
If ename is not supplied, then the value of the parameter FCEDIT 
(default /bin/ed) is used as the editor. When editing is complete, 
the edited command(s) is executed. If last is not specified then it 
will be set to first. U first is not specified the default is the previ- 
ous command for editing and -16 for listing. The flag -r reverses 
the order of the commands and the flag -n suppresses command 
numbers when listing. In the second form the command is re- 
executed after the substitution old=new is performed. 
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fg [ job. . . ] 

This command is only on systems that support job control. Each 
job specified is brought to the foreground. Otherwise, the current 
job is brought into the foreground. See Jobs for a description of 
the format of job. 

getopts optstring name [ arg ... \ 

Checks arg for legal options. If arg is omitted, the positional 
parameters are used. An option argument begins with a + or a -. 
An option not beginning with + or - or the argument - - ends the 
options, optstring contains the letters that getopts recognizes. If a 
letter is followed by a :, that option is expected to have an argu- 
ment. The options can be separated from the argument by blanks, 
getopts places the next option letter it finds inside variable name 
each time it is invoked with a + prepended when arg begins with a 
+. The index of the next arg is stored in OPTIND. The option 
argument, if any, gets stored in OPTARG. 

A leading : in optstring causes getopts to store the letter of an 
invalid option in OPTARG, and to set name to ? for an unknown 
option and to : when a required option is missing. Otherwise, 
getopts prints an error message. The exit status is non-zero when 
there are no more options. 

jobs [ -Inp 1 [ job ... 1 

Lists information about each given job; or all active jobs if job is 
omitted. The -I flag lists process ids in addition to the normal in- 
formation. The -n flag only displays jobs that have stopped or 
exited since last notified. The -p flag causes only the process 
group to be listed. See Jobs for a description of the format of job. 

kill [ -sig ]job ... 

kill -1 

Sends either the TERM (terminate) signal or the specified signal to 
the specified jobs or processes. Signals are either given by number 
or by names (as given in /usr/include/signal.h, stripped of the 
prefix “SIG”). If the signal being sent is TERM (terminate) or 
HUP (hangup), then the job or process will be sent a CONT (con- 
tinue) signal if it is stopped. The argument job can the process id 
of a process that is not a member of one of the active jobs. See 
Jobs for a description of the format of job. In the second form, kill 
- 1 , the signal numbers and names are listed. 

let arg . . . 

Each arg is a separate arithmetic expression to be evaluated. See 
Arithmetic Evaluation above, for a description of arithmetic 
expression evaluation. 

The exit status is 0 if the value of the last expression is non-zero, 
and 1 otherwise. 

t newgrp {arg ...] 

Equivalent to exec /bin/nevvgrp arg .... 
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print [ -Rnprsu In ] ][ arg ... ] 

The shell output mechanism. With no flags or with flag - or - - the 
arguments are printed on standard output as described by echo(C). 
In raw mode, -R or -r, the escape conventions of echo are ignored. 
The -R option will print all subsequent arguments and options 
other than -n. The -p option causes the arguments to be written 
onto the pipe of the process spawned with | & instead of standard 
output. The -s option causes the arguments to be written onto the 
history file instead of standard output. The -u flag can be used to 
specify a one digit file descriptor unit number n on which the out- 
put will be placed. The default is 1. If the flag -n is used, no new- 
line is added to the output. 

pwd 

Equivalent to print -r - $PWD 

read [ -prsu [ /^ ] ] [ namelprompt ] [ name . . . ] 

The shell input mechanism. One line is read and is broken up into 
fields using the characters in IFS as separators. In raw mode, -r, a \ 
at the end of a line does not signify line continuation. The first 
field is assigned to the first name, the second field to the second 
name, etc., with leftover fields assigned to the last name. The -p 
option causes the input line to be taken from the input pipe of a 
process spawned by the shell using | &. If the -s flag is present, the 
input will be saved as a command in the history file. The flag -u 
can be used to specify a one digit file descriptor unit to read from. 
The file descriptor can be opened with the exec special command. 
The default value of n is 0. If name is omitted then REPLY is used 
as the default name. The exit status is 0 unless an end-of-file is 
encountered. An end-of-file with the -p option causes cleanup for 
this process so that another can be spawned. If the first argument 
contains a ?, the remainder of this word is used as a prompt on 
standard error when the shell is interactive. The exit status is 0 
unless an end-of-file is encountered. 

tt readonly [ name[ rvalue ] ] . . . 

The given names are marked readonly and these names cannot be 
changed by subsequent assignment. 

t return [ n ] 

Causes a shell function to return to the invoking script with the 
return status specified by n. If « is omitted then the return status is 
that of the last command executed. If return is invoked while not 
in di function or a . script, then it is the same as an exit. 

set [ ±aefhkmnopstuvx ] [ ±o option ]. . . [ ±A name ] [ arg ... ] 
The flags for this command have meaning as follows: 

-A Array assignment. Unset the variable name and assign 
values sequentially from the list arg. If +A is used, the 
variable name is not unset first. 
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-a 



-e 



-f 

-h 



-k 



-m 



-n 



-o 



All subsequent parameters that are defined are automati- 
cally exported. 

If a command has a non-zero exit status, execute the 
ERR trap, if set, and exit. This mode is disabled while 
reading profiles. 

Disables file name generation. 

Each command becomes a tracked alias when first 
encountered. 

All parameter assignment arguments are placed in the 
environment for a command, not just those that precede 
the command name. 

Background jobs will run in a separate process group and 
a line will print upon completion. The exit status of 
background jobs is reported in a completion message. 
On systems with job control, this flag is turned on auto- 
matically for interactive shells. 

Read commands and check them for syntax errors, but do 
not execute them. Ignored for interactive shells. 

The following argument can be one of the following 
option names: 



allexport 

errexit 

bgnice 

emacs 

gniacs 

ignoreeof 

keyword 

markdirs 

monitor 

noclobber 



noexec 

noglob 

nolog 

nounset 

privileged 

verbose 

trackall 

vi 



Same as -a. 

Same as -e. 

All background jobs are run at a lower prior- 
ity. This is the default mode. 

Puts you in an emacs style in-line editor for 
command entry. 

Puts you in a gmacs style in-line editor for 
command entry. 

The shell will not exit on end-of-file. The 
command exit must be used. 

Same as -k. 

All directory names resulting from file name 
generation have a trailing / appended. 

Same as -m. 

Prevents redirection > from truncating exist- 
ing files. Require > | to truncate a file when 
turned on. 

Same as -n. 

Same as -f. 

Do not save function definitions in history 
file. 

Same as -u. 

Same as -p. 

Same as -v. 

Same as -h. 

Puts you in insert mode of a vi style in-line 
editor until you hit escape character 033. 
This puts you in move mode. A return sends 
the line. 
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viraw Each character is processed as it is typed in 
vi mode. 

xtrace Same as -x. 

If no option name is supplied then the current option set- 
tings are printed. 

-p Disables processing of the $HOME/.profile file and uses 

the file /etc/suid_profile instead of the ENV file. This 
mode is on whenever the effective uid (gid) is not equal 
to the real uid (gid). Turning this off causes the effective 
uid and gid to be set to the real uid and gid. 

-s Sort the positional parameters lexicographically. 

-t Exit after reading and executing one command. 

-u Treat unset parameters as an error when substituting. 

-V Print shell input lines as they are read. 

-X Print commands and their arguments as they are exe- 

cuted. 

Turns off -x and -v flags and stops examining arguments 
for flags. 

Do not change any of the flags; useful in setting $1 to a 
value beginning with -. If no arguments follow this flag 
then the positional parameters are unset. 

Using + rather than - causes these flags to be turned off. These 
flags can also be used upon invocation of the shell. The current set 
of flags may be found in $-. Unless -A is specified, the remaining 
arguments are positional parameters and are assigned, in order, to 

$1 $2 If no arguments are given then the names and values of 

all named parameters are printed on the standard output. If the 
only argument is +, the names of all named parameters are printed. 

t shift [ n ] 

The positional parameters from $/ 2 +l ... are renamed $1 ... , 
default n is 1. The parameter n can be any arithmetic expression 
that evaluates to a non-negative number less than or equal to $#. 

t times 

Print the accumulated user and system times for the shell and for 
processes run from the shell. 

t trap [arg ][ sig ] . . . 

arg is a command to be read and executed when the shell receives 
signal(s) sig. (Note that arg is scanned once when the trap is set 
and once when the trap is taken.) Each sig can be given as a num- 
ber or as the name of the signal. Trap commands are executed in 
order of signal number. Any attempt to set a trap on a signal that 
was ignored on entry to the current shell is ineffective. If arg is 
omitted oris -, then all trap(s) sig are reset to their original values. 
If arg is the null string then this signal is ignored by the shell and 
by the commands it invokes. If sig is ERR then arg will be exe- 
cuted whenever a command has a non-zero exit status, sig is 
DEBUG then arg will be executed after each command. If sig is 0 
or EXIT and the trap statement is executed inside the body of a 
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function, then the command arg is executed after the function 
completes. If slg is 0 or EXIT for a trap set outside any function 
then the command arg is executed on exit from the shell. The trap 
command with no arguments prints a list of commands associated 
with each signal number. 

tt typeset [ ±HLRZfilrtux[n] ] [ name[ =value ] ] ... 

Sets attributes and values for shell parameters. When invoked 
inside a function, a new instance of the parameter name is created. 
The parameter value and type are restored when the function com- 
pletes. The following list of attributes may be specified: 

-H This flag provides UNIX system to host-name file mapping on 
non-UNIX system machines. 

-L Left justify and remove leading blanks from value . If « is non- 
zero it defines the width of the field, otherwise it is determined 
by the width of the value of first assignment. When the param- 
eter is assigned to, it is filled on the right with blanks or trun- 
cated, if necessary, to fit into the field. Leading zeros are 
removed if the -Z flag is also set. The -R flag is turned off. 

-R Right justify and fill with leading blanks. If n is non-zero it 
defines the width of the field, otherwise it is determined by the 
width of the value of first assignment. The field is left filled 
with blanks or truncated from the end if the parameter is reas- 
signed. The L flag is turned off. 

-Z Right justify and fill with leading zeros if the first non-blank 
character is a digit and the -L flag has not been set. If n is non- 
zero it defines the width of the field, otherwise it is determined 
by the width of the value of first assignment. 

-f The names refer to function names rather than parameter 
names. No assignments can be made and the only other valid 
flags are -t, -u and -x. The flag -t turns on execution tracing for 
this function. The flag -u causes this function to be marked 
undefined. The FPATH variable will be searched to find the 
function definition when the function is referenced. The flag -x 
allows the function definition to remain in effect across shell 
procedures invoked by name. 

-i Parameter is an integer. This makes arithmetic faster. If n is 
non-zero it defines the output arithmetic base, otherwise the 
first assignment determines the output base. 

-1 All upper-case characters converted to lower-case. The upper- 
case flag, -u is turned off. 

-r The given names are marked readonly and these names cannot 
be changed by subsequent assignment. 

-t Tags the named parameters. Tags are user definable and have 
no special meaning to the shell. 

-u All lower-case characters are converted to upper-case charac- 
ters. The lower-case flag, -1 is turned off. 

-X The given names are marked for automatic export to the 
environment of subsequently-executed commands. 
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Using + rather than - causes these flags to be turned off. If no 
name arguments are given but flags are specified, a list of names 
(and optionally the values) of the parameters which have these 
flags set is printed. (Using + rather than - keeps the values from 
being printed.) If no names and flags are given, the names and - 
attributes of all parameters are printed. 

ulimit [ -HS ] [ limit ] 

The number of 512-byte blocks on files written by child processes 
(files of any size may be read). The limit is set when limit is 
specifed. The value of limit can be a number or the value unlim- 
ited. The H and S flags specify whether the hard limit or the soft 
limit is set. A hard limit cannot be increased once it is set. A soft 
limit can be increased up to the value of the hard limit. If neither 
the H or S options is specified, the limit applies to both. The 
current limit is printed when limit is omitted. In this case the soft 
limit is printed unless H is specified. 

umask [ mask ] 

The user file-creation mask is set to mask (see umask{C)), mask 
can either be an octal number or a symbolic value as described in 
chmodiC). If a symbolic value is given, the new umask value is 
the complement of the result of applying mask to the complement 
of the previous umask value. If mask is omitted, the current value 
of the mask is printed. 

unalias name . . . 

The parameters given by the list of names are removed from the 
alias list. 

unset [ -f ] name . . . 

The parameters given by the list of names are unassigned, i. e., 
their values and attributes are erased. Readonly variables cannot 
be unset. If the flag, -f, is set, then the names refer to function 
names. Unsetting ERRNO, LINENO, MAILCHECK, OPTARG, 
OPTIND, RANDOM, SECONDS, TMOUT, and __ causes removes 
their special meaning even if they are subsequently assigned to. 

t wait [ job ] 

Wait for the specified job and report its termination status. If job is 
not given then all currently active child processes are waited for. 
The exit status from this command is that of the process waited for. 
See Jobs for a description of the format of job. 

whence [ -pv ] name . . . 

For each name, indicate how it would be interpreted if used as a 
command name. 

The flag, -v, produces a more verbose report. 

The flag, -p, does a path search for name even if name is an alias, a 
function, or a reserved word. 
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Invocation. 

If the shell is invoked by exec{S), and the first character of argument 
zero ($0) is then the shell is assumed to be a login shell and com- 
mands are read from /etc/profile and then from either .profile in the 
current directory or $HOME/.profile, if either file exists. Next, com- 
mands are read from the file named by performing parameter substitu- 
tion on the value of the environment parameter ENV if the file exists. 
If the -s flag is not present and arg is, then a path search is performed 
on the first arg to determine the name of the script to execute. The 
script arg must have read permission and any setuid and getgid set- 
tings will be ignored. Commands are then read as described below; 
the following flags are interpreted by the shell when it is invoked: 

-c string If the -c flag is present then commands are read from 
string . 

-s If the -s flag is present or if no arguments remain then 

commands are read from the standard input. Shell output, 
except for the output of the Special commands listed 
above, is written to file descriptor 2. 

-i If the -i flag is present or if the shell input and output are 

attached to a terminal (as told by ioctl(S)) then this shell 
is interactive . In this case TERM is ignored (so that kill 0 
does not kill an interactive shell) and INTR is caught and 
ignored (so that wait is interruptible). In all cases, QUIT 
is ignored by the shell. 

-r If the -r flag is present the shell is a restricted shell. 

The remaining flags and arguments are described under the set com- 
mand above. 



rksh Only. 

rksh is used to set up login names and execution environments whose 
capabilities are more controlled than those of the standard shell. The 
actions of rksh are identical to those of ksh, except that the following 
are disallowed: 

changing directory (see a/(C)), 
setting the value of SHELL, ENV, or PATH, 
specifying path or command names containing /, 
redirecting output (>,>],<>, and »). 

The restrictions above are enforced after .profile and the ENV files a**e 
interpreted. 

When a command to be executed is found to be a shell procedure, rksh 
invokes ksh to execute it. Thus, it is possible to provide to the end- 
user shell procedures that have access to the full power of the standard 
shell, while imposing a limited menu of commands; this scheme 
assumes that the end-user does not have write and execute permissions 
in the same directory. 
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The net effect of these rules is that the writer of the .profile has com- 
plete control over user actions, by performing guaranteed setup 
actions and leaving the user in an appropriate directory (probably not 
the login directory). 

The system administrator often sets up a directory of commands (i.e., 
/usr/rbin) that can be safely invoked by rksh. Some systems also pro- 
vide a restricted editor red. 

Diagnostics 



Errors detected by the shell, such as syntax errors, cause the shell to 
return a non-zero exit status. Otherwise, the shell returns the exit 
status of the last command executed (see also the exit command 
above). If the shell is being used non-interactively then execution of 
the shell file is abandoned. Run time errors detected by the shell are 
reported by printing the command or function name and the error con- 
dition. If the line number that the error occurred on is greater than 
one, then the line number is also printed in square brackets ([]) after 
the command or function name. 

Files 



/etc/passwd 

/etc/profile 

/etc/suid_profile 

$HOME/.profile 

/tmp/sh* 

/dev/null 

See Also 



cat(C), cd(C), chmod(C), cut(C), echo(C), env(C), newgrp(C), stty(C), 
test(C), umask(C), vi(C), dup(S), exec(S), fork(S), ioctl(S), Iseek(S), 
paste(C), pipe(S), signal(S), umask(S), ulimit(S), wait(S), rand(S), 
a.out(F), profile(M), environ(M). 

Notes 



If a command which is a tracked alias is executed, and then a com- 
mand with the same name is installed in a directory in the search path 
before the directory where the original command was found, the shell 
will continue to exec the original command. Use the -t option of the 
alias command to correct this situation. 
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Some very old shell scripts contain a " as a synonym for the pipe char- 
acter. |. 

Using the fc built-in command within a compound command will 
cause the whole command to disappear from the history file. 

The built-in command ,file reads the whole file before any commands 
are executed. Therefore, alias and unalias commands in the file will 
not apply to any functions defined in the file. 

Traps are not processed while a job is waiting for a foreground pro- 
cess. Thus, a trap on CHLD won't be executed until the forground job 
terminates. 
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I 

lists information about contents of directory 

Syntax 

1 [ -ACFRabcdfgilnopqrstu ] name ... 

Description 



For each directory argument, / lists the contents of the directory. For 
each name, I repeats its name and other requested information. The 
output is sorted alphabetically by default. When no argument is 
given, the current directory is listed. When several arguments are 
given, the arguments are first sorted appropriately, but file arguments 
appear before directories and their contents. Information is listed in 
the format of the “Is -1“ command, which is identical to the / com- 
mand. This format and all provided switches are described in ls{C) 
and /c(C), to which should you should refer for a complete discussion 
of the capabilities of /. 

Files 



/etc/passwd Contains user IDs 

/etc/group Contains group IDs 

Notes 



Newline and tab are considered printing characters in filenames. 
The output device is assumed to be 80 columns wide. 
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last 

indicate last logins of users and teletypes 

Syntax 



last [ -h ] [ -n limit ] [ -t tty ] [ -w wtmpfile ] [ name ] 

Description 



last checks the wtmp file, which records all logins and logouts for in- 
formation about a user, a serial line or any group of users and lines. 
Arguments specify a user name and/or tty. 

last -t 01 root 

would list all “root” sessions as well as all sessions on /dev/ttyOl. 
last prints the sessions of the specified users and ttys, including login 
name, the line used, the device name, the process ID, plus start time 
and elapsed time. 

last with no arguments prints a record of all logins and logouts, in 
reverse chronological order. 

The options behave as follows: 

-h no header. 

-n limit 

limits the report to n lines. 

-t line 

specifies the tty. 

•wwtmpfile 

uses wtmpfile instead of /etc/ wtmp. 

Files 



/etc/wtmp 

See Also 



login data base 



finger(C), utmp(M), accton(ADM), acctcom(ADM), acct(F) 
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layers 

layer multiplexer for windowing terminals 

Syntax 

layers [-s] [-t] [-dj [-pj [-f file] [layersys-prgm] 

Description 



The layers command manages asynchronous windows [see layers(M)\ 
on a windowing terminal. Upon invocation, layers finds an unused 
x^(HW) channel group and associates it with the terminal line on its 
standard output. It then waits for commands from the terminal. 

Command-line options: 

-s Reports protocol statistics on standard error at the end of the 

session after you exit from layers. The statistics may be 
printed during a session by invoking the program ADM). 

-t Turns on xr(HW) driver packet tracing, and produces a trace 

dump on standard error at the end of the session after you 
exit from layers. The trace dump may be printed during a 
session by invoking the program x/^(ADM). 

-d If a firmware patch has been downloaded, prints out the 

sizes of the text, data, and bss portions of the firmware patch 
on standard error. 

-p If a firmware patch has been downloaded, prints the down- 

loading protocol statistics and a trace on standard error. 

-f file Starts layers with an initial configuration specified by file. 

Each line of the file represents a layer to be created, and has 
the following format: 

origin_x origin_y corner_x corner_y commandjist 

The coordinates specify the size and position of the layer on 
the screen in the terminal’s coordinate system. If all four are 
0, the user must define the layer interactively. 
command Jist, a list of one or more commands, must be pro- 
vided. It is executed in the new layer using the user’s shell 
(by executing: $SHELL -i -c '' command Jist^'). This means 
that the last command should invoke a shell, such as /bin/sh. 
(If the last command is not a shell, then, when the last com- 
mand has completed, the layer will not be functional.) 
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layersys-prgm 

A file containing a firmware patch that the layers command 
downloads to the terminal before layers are created and 
commandjist is executed. 

Each layer is in most ways functionally identical to a separate termi- 
nal. Characters typed on the keyboard are sent to the standard input of 
the UNIX system process attached to the current layer (called the host 
process), and characters written on the standard output by the host pro- 
cess appear in that layer. When a layer is created, a separate shell is 
established and bound to the layer. If the environment variable 
SHELL is set, the user will get that shell, otherwise, /bin/sh will be 
used. In order to enable communications with other users via 
write(C), layers invokes the command relogin(ADM) when the first 
layer is created. relogin(ADM) will reassign that layer as the user’s 
logged-in terminal. An alternative layer can be designated by using 
relogin(ADM) directly, layers will restore the original assignment on 
termination. 

Layers are created, deleted, reshaped, and otherwise manipulated in a 
terminal-dependent manner. For instance, the AT&T TELE- 
TYPE 5620 DMD terminal provides a mouse-activated pop-up menu 
of layer operations. The method of ending a layers session is also 
defined by the terminal. 

Example 



layers -f startup 

where startup contains 

8 8 700 200 date ; pwd ; exec $SHELL 
8 300 780 850 exec $SHELL 



Notes 



The x/(HW) driver supports an alternate data transmission scheme 
known as ENCODING MODE. This mode makes layers operation pos- 
sible even over data links which intercept control characters or do not 
transmit 8-bit characters. ENCODING MODE is selected either by set- 
ting a configuration option on your windowing terminal or by setting 
the environment variable DMDLOAD to the value hex before running 
layers: 

export DMDLOAD; DMDLOAD=hex 

If, after executing layers -f file, the terminal does not respond in one 
or more of the layers, often the last command in the command-list for 
that layer did not invoke a shell. 
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When invoking layers with the -s, -t, -d, or -p options, it is best to 
redirect standard error to another file to save the statistics and tracing 
output (e.g., layers -s 2>stats); otherwise all or some of the output 
may be lost. 

Files 



/dev/xt??[0-7] 
/usr/lib/layersys/lsys.8;7;3 
/usr/lib/layersy s/lsy s . 8 ; ?; ? 

See Also 



relogin(ADM), sh(C), write(C), wtinit(ADM), xts(ADM), xtt(ADM), 
xt(HW), libwindows(S), layers(M) 
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Ic 

lists directory contents in columns 

Syntax 

Ic [ -lACFRabcdfgilninopqrstux ] name ... 

Description 



Ic lists the contents of files and directories, in columns. If name is a 
directory name, Ic lists the contents of the directory; if name is a 
filename, Ic repeats the filename and any other information requested. 
Output is given in columns and sorted alphabetically. If no argument 
is given, the current directory is listed. If several arguments are given, 
they are sorted alphabetically, but file arguments appear before direc- 
tories. 

Files that are not the contents of a directory being interpreted are 
always sorted across the page rather than down the page in columns. 
A stream output format is available in which files are listed across the 
page, separated by commas. The -m option enables this format. 

The options are: 

-1 Forces an output format with one entry per line. 

-A If not the root directory, this option displays all files that begin 
with (except and themselves). Otherwise, files are 
displayed normally. 

-C Forces columnar output, even if redirected to a file. 

-F Causes directories to be marked with a trailing and executable 
files to be marked with a trailing 

-R Recursively lists subdirectories. 

-a Lists all entries; and are not suppressed. 

-b Forces printing of nongraphic characters in the \idd notation, m 
octal. 

-c Sorts by time of file creation, for use with -t option. 

-d If the argument is a directory, lists only its name, not its contents 
(mostly used with -1 to get status on directory). 
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-f Forces each argument to be interpreted as a directory and lists the 
name found in each slot. This option turns off -1, -t, -s, and -r, and 
turns on -a. The order is the order in which entries appear in the 
directory. 

-g The same as -1, except that the owner is not printed. 

-i Prints inode number in first column of the report for each file 
listed. 

-1 Lists in long format, giving mode, number of links, owner, group, 
size in bytes, and time of last modification for each file. If the file 
is a special file, the size field contains the major and minor device 
numbers instead. 



-m 

Forces stream output format. 

-n Same as the -I switch, but the owner’s user ID appears instead of 
the owner’s name. If used in conjunction with the -g switch, the 
owner’s group ID appears instead of the group name. 

-o The same as -1, except that the group is not printed. 

-p Pad output with spaces. 

-q Forces printing of nongraphic characters in filenames as the char- 
acter “?”. 

-r Reverses the order of sort to get reverse alphabetic or oldest first as 
appropriate. 

-s Gives size in 512-byte blocks, including indirect blocks for each 
entry. 

-t Sorts by time modified (latest first) instead of by name, as is nor- 
mal. 

-u Uses time of last access instead of last modification for sorting (-t) 
or printing (-1). 

-X Forces columnar printing to be sorted across rather than down the 
page. 

The following are alternate invocations of the Ic command: 

If Produces the same output as Ic -F. 

Ir Produces the same output as Ic -R. 
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lx Produces the same output as Ic -x. 

The mode printed under the -I option contains 1 1 characters. The first 
character is: 

If the entry is a plain file 
d If the entry is a directory 
b If the entry is a block-type special file 
c If the entry is a character- type special file 
p If the entry is a named pipe 
s If the entry is a semaphore 
m If the entry is shared data (memory) 

The next 9 characters are interpreted as 3 sets of 3 bits each. The first 
set refers to owner permissions; the next to permissions of others in 
the same user-group; and the last to all others. Within each set, the 3 
characters indicate permission to read, to write, or to execute the file 
as a program, respectively. For a directory, “execute” permission is 
interpreted to mean permission to search the directory for a specified 
file. The permissions are indicated as follows: 

r If the file is readable 

w If the file is writable 

X If the file is executable 

- If the indicated permission is not granted 

The group-execute permission character is given as s if the file has 
set-group-ID mode; likewise the user-execute permission character is 
given as s if the file has set- user- ID mode. 

The last character of the mode (normally “x” or is t if the 1000 
bit of the mode is on. See chmod(C) for the meaning of this mode. 

When the sizes of the files in a directory are listed, a total count of 
blocks, including indirect blocks, is displayed. 
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Files 




/etc/passwd 


To get user IDs for “Ic -o” 


/etc/group 


To get group IDs for “Ic -g“ 


Credit 




This Utility was developed at the University of California at Berkeley 
and is used with permission. 


Notes 





Newline and tab are considered printing characters in filenames. The 
output device is assumed to be 80 columns wide. Column width 
choices are poor for terminals that can tab. 

This utility reports sizes in 512 byte blocks. Ic -s will report 2 blocks 
used, rather than 1 block, since the file uses one system block of 1024 
bytes. 
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line 

reads one line 

Syntax 

line 

Description 



line copies one line (up to a newline) from the standard input and 
writes it on the standard output. It returns an exit code of 1 on end- 
of-file and always prints at least a newline. It is often used within 
shell files to read from the user’s terminal. 

See Aiso 



gets(CP), sh(C) 

Standards Conformance 



line is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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In 

makes a link to a file 

Syntax 

In [-f]filel [file2 ...] target 

Description 



A link is a directory entry referring to a file. The same file (together 
with its size, all its protection information, etc) may have several links 
to it. There is no way to distinguish a link to a file from its original 
directory entry. Any changes to the file are effective independent of 
the name by which the file is known. 

If target is a directory, then one or more files are linked to that direc- 
tory. 

If In determines that the mode of target forbids writing, it will print 
the mode [see chmod{C)\, ask for a response, and read the standard 
input for one line. If the line begins with y, the In occurs, if permissi- 
ble; if not, the command exits. 

When the -f option is used or if the standard input is not a terminal, no 
questions are asked and the In is done. 

See Also 



cp(C), mv(C), rm(C) 

Standards Conformance 



In is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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lock 

locks a user’s terminal 

Syntax 



lock [-v] [ -number ] 

Description 



lock requests a password from the user, requests it again for verifica- 
tion, then locks the terminal until the password is reentered. If a 
-number is specified in the lock command, the terminal is automati- 
cally logged out and made available to another user after that number 
of minutes has passed. 

This command uses the file ! etc! default! lock. This file has two entries: 

DEFLOGOUT = number 
MAXLOGOUT = number 

DEFLOGOUT specifies the default time in minutes a terminal will 
remain locked before the user is logged out. This default value is 
overridden if the -number option is used on the command line. If 
DEFLOGOUT and -number are not specified, the MAXLOGOUT 
value is used. 

MAXLOGOUT is the maximum number of minutes a user is permit- 
ted to lock a terminal. If a user attempts to lock a terminal for longer 
than this time, lock will issue a warning to the user that it is using the 
system maximum time limit. If DEFLOGOUT and -number and 
MAXLOGOUT are not specified, users are not logged out. 

DEFLOGOUT and MAXLOGOUT are configured by the system 
administrator to reflect the demand for terminals at the site. 

The lock may be terminated by killing the lock process. Only the 
superuser and the user who invoked lock may do so. 

Options 



■number Sets the time limit for lock to number of minutes, instead 
of the system default. 
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-V 

Files 



Specifies verbose operation. 



/etc/default/lock 

Notes 



The file ! etc! default! lock is shipped with the following default values: 

DEFLOGOUT = 30 
MAXLOGOUT =60 
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logname 

gets login name 

Syntax 



logname 

Description 



logname returns the user’s login name as found in letclutmp. If no log- 
in name is found, logname returns the user’s user ID number. 

See Also 



env(C), id(C), getlogin(S), getuid(S), login(M), logname(S) 

Standards Conformance 



logname is conformant with: 

The X/Open Portability Guide II of January 1987. 
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Ip, cancel 

send/cancel requests to lineprinter 

Syntax 

Ip [options] flies 
Ip -i id printing options 
cancel [ids] [printers] 

Description 



The first form of the Ip shell command arranges for the named files 
and associated information (collectively called a request) to be 
printed. If no file names are specified on the shell command line, the 
standard input is assumed. The standard input may be specified along 
with named files on the shell command line using the file name. The 
files will be printed in the order they appear on the shell command 
line. 

The second form of Ip is used to change the options for a request. The 
print request identified by the request-id is changed according to the 
printing options specified with this shell command. The printing 
options available are the same as those with the first form of the Ip 
shell command. If request-id has finished printing, the change is 
rejected. If the request-id is already printing, it will be stopped and 
restarted from the beginning, unless the -P option has been given. 

Ip associates a unique id with each request and prints it on the stan- 
dard output. This id can be used later to cancel, change, or find the 
status of the request. (See the section on cancel for details about can- 
celing a request, the previous paragraph for an explanation of how to 
change a request, and lpstat(C) for information about checking the 
status of a print request.) 

Sending a Print Request 



The first form of the Ip command is used to send a print request to a 
particular printer or group of printers. 

Options to Ip must always precede file names but may be listed in any 
order. The following options are available for Ip: 

-c When Ip is invoked, copies of the files to be printed are 

made immediately. Normally, files will not be copied. If 
the -c option is not given, then the user should be careful not 
to remove any of the files before the request has been printed 
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in its entirety. It should also be noted that in the absence of 
the -c option, any changes made to the named files after the 
request is made but before it is printed will be reflected in 
the printed output. 

•ddest Prints this request using dest as the printer or class of 
printers. Under certain conditions (lack of printer availabil - 
ity, capabilities of printers, and so on), requests for specific 
destinations may not be accepted [see accept (ADM) and 
lpstat(C)]. By default, dest is taken from the environment 
variable LPDEST (if it is set). Otherwise, a default destina- 
tion (if one exists) for the computer system is used. Destina- 
tion names vary between systems [see lpstat(C)], 

4 form-name [-d any] 

Prints the request on the form form-name. The LP print ser- 
vice ensures that the form is mounted on the printer. If 
form-name is requested with a printer destination that can- 
not support the form, the request is rejected. If form-name 
has not been defined for the system or if the user is not 
allowed to use the form, the request is rejected [see 
Ipforms(ADM)]. When the -d any option is given, the 
request is printed on any printer that has the requested form 
mounted and can handle all other needs of the print request. 

-H special-handling 

Prints the request according to the value of special-handling. 
Acceptable values for special-handling are hold, resume, 
and immediate, as defined below: 

hold Won’t print the request until notified. If already 
printing, stops it. Other print requests will go 
ahead of a held request until it is resumed. 

resume Resumes a held request. If it had been printing 
when held, it will be the next request printed, 
unless subsequently bumped by an immediate 
request. 

immediate 

(Available only to LP administrators) 

Prints the request next. If more than one request is 
assigned immediate, the requests are printed in 
the reverse order queued. If a request is currently 
printing on the desired printer, you have to put it 
on hold to allow the immediate request to print. 

-m Sends mail [see mail(C)] after the files have been printed. 

By default, no mail is sent upon normal completion of the 
print request. 
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-n number 

Prints number copies of the output (default is 1). 

-o Specifies printer-dependent or class-dependent options. 

Several such options may be collected by specifying the -o 

keyletter more than once. The standard interface recognizes 

the following options: 

nobanner 

Does not print a banner page with this request. (The 
administrator can disallow this option at any time.) 

nofilebreak 

Does not insert a form feed between the files given if 
submitting a job to print more than one file. 

\eTigth=scaled-decimal-number 

Prints the output of this request with pages scaled- 
decimal-number lines long. A scaled-decimal-num- 
ber is an optionally scaled decimal number that gives 
a size in lines, columns, inches, or centimeters, as ap- 
propriate. The scale is indicated by appending the 
letter “i” (for inches) or the letter “c” (for centime- 
ters). For length or width settings, an unsealed num- 
ber indicates lines or columns; for line pitch or char- 
acter pitch settings, an unsealed number indicates 
lines per inch or characters per inch (the same as a 
number scaled with “i”). For example, length=66 
indicates a page length of 66 lines, length=lli indi- 
cates a page length of 1 1 inches, and length=27.94c 
indicates a page length of 27.94 centimeters. 

This option cannot be used with the -f option. 

yf\dih=scaled-decimal-number 

Prints the output of this request with page-width set 
to scaled-decimal-number columns wide. (See the 
explanation above for scaled-decimal-numbers.) 
This option cannot be used with the -f option. 

Ipi =scaled-decimal-number 

Prints this request for “lines per inch” with the line 
pitch set to scaled-decimal-number lines per inch. 
This option cannot be used with the -f option. 

cpi=scaled-decimal-number 

Prints this request for “characters per inch” with the 
character pitch set to scaled-decimal-number charac- 
ters per inch. Character pitch can also be set to pica 
(representing 10 columns per inch) or elite 
(representing 12 columns per inch), or it can be 
compressed, which is as many columns as a printer 
can handle. There is no standard number of columns 
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per inch for all printers; see the terminfo(F) database 
for the default character pitch for your printer. The 
cpi option cannot be used in conjunction with the -f 
option. 

stiy=stty-option-list 

Set the printer with a list of options valid for the stty 
command. Enclose the list with quotes if it contains 
blanks. 



-P page-list 

Prints the page(s) specified in page-list. This option can be 
used only if there is a filter available to handle it; otherwise, 
the print request will be rejected. 

The page-list may consist of range(s) of numbers, single 
page numbers, or a combination of both. The pages will be 
printed in ascending order. 

-q priority-level 

Assigns this request priority -level in the printing queue. 
The values of priority -level range from 0, the highest prior- 
ity, to 39, the lowest priority. If a priority is not specified, 
the default for the print service is used, as assigned by the 
system administrator. 

-s Suppresses messages from lp(C) such as “request id is . . 

-S character-set [-d any] 

-S print-wheel [-d any] 

Prints this request using the specified character-set or print- 
wheel. If a form has been specified that requires a 
character- set or print-wheel other than the one specified 
with the -S option, the request is rejected. 

For printers that take print wheels: if the print-wheel 
specified is not one listed by the administrator as acceptable 
for the printer involved in this request, the request is 
rejected unless the print wheel is already mounted on the 
printer. For printers that use selectable or programmable 
character sets: if the character-set specific is not one 
defined in the terminfo database for the printer [see 
terminfo(F)] or is not an alias defined by the administrator, 
the request is rejected. 

When the -d any option is used, the request is printed on any 
printer that has the print wheel mounted or any printer that 
can select the character set and can handle all other needs of 
the request. 

-t title Prints title on the banner page of the output. The default is 
no title. 
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-T content-type [-r] 

While the printer type information tells the print service 
what type of printer is being added, the content type infor- 
mation tells the print service what types of files can be 
printed. Prints the request on a printer that can support the 
specified content-type. If no printer accepts this type 
directly, a filter will be used to convert the content into an 
acceptable type. If the -r option is specified, a filter will not 
be used. If -r is specified but no printer accepts the 
content-type directly, the request is rejected. If the content- 
type is not acceptable to any printer, either directly or with a 
filter, the request is rejected. 

-w Writes a message on the user’s terminal after the files have 
been printed. If the user is not logged in, then mail will be 
sent instead. 

-y mode-list 

Prints this request according to the printing modes listed in 
mode-list. The allowed values for mode-list are locally 
defined. This option can be used only if there is a filter 
available to handle it; if there is no filter, the print request 
will be rejected. 

Canceling a Print Request 



The cancel command cancels printer requests that were made by the 
/p(C) shell command. The shell command line arguments may be 
either request-ids [as returned by /p(C)] or printer names [for a com- 
plete list, use lpstat{C)\. Specifying a request-id cancels the associ- 
ated request even if it is currently printing. Specifying a printer can- 
cels the request that is currently printing on that printer. In either 
case, the cancellation of a request that is currently printing frees the 
printer to print its next available request. 

Special Options 



-R Removes file after sending it. 

-L Local printing option. Sends print job to printer 
attached to the terminal. 

The file /etc/default/lpd contains the setting of the variable 
BANNERS, whose value is the number of pages printed as a banner 
identifying each printout. This is normally set to either 1 or 2. 

The variables LPR and PRINTER can each be set to ‘spooler’ or ‘local’. 
These variables let you send files to the spool printer or the terminal’s 
local printer, respectively. The file msr/bin/spool contains the 
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‘spooler’ setting for both variables. The file /usr/bin/local contains 
the ‘local’ setting. The following are a few examples of variable 
usage: 

Ip -option spooler 

LPR=local 

LPR=spooler 

spool Ip -option device file 

Notes 



Printers for which requests are not being accepted will not be con- 
sidered when the destination is any. (Use the Ipstat -a command to 
see which printers are accepting requests.) On the other hand, if a 
request is destined for a class of printers and the class itself is accept- 
ing requests, all printers in the class will be considered, regardless of 
their acceptance status, as long as the printer class is accepting 
requests. 

Warning 



For printers that take mountable print wheels or font cartridges, if you 
do not specify a particular print wheel or font with the -S option, 
whichever happens to be mounted at the time your request prints will 
be used. Use the Ipstat -p -1 command to see what print wheels are 
available. For printers that have selectable character sets, you will get 
the standard set if you don’t give the -S option. 

Files 



/usr/spool/lp/* 

/etc/defaull^pd 

See Also 



enable(C), Ipstat(C), mail(C), accept(ADM), Ipadmin(ADM), 
Ipfilter(ADM), Ipforms(ADM), Ipsched(ADM), Ipusers(ADM), 
terminfo(F) 

Standards Conformance 



cancel and Ip are conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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■print 

print to a printer attached to the user’s terminal 

Syntax 



Iprint [ - ] [ file ] 

Description 



IprintiC) accepts a filename to print or - to read from the keyboard. If 
the terminal has local printing abilities, it will then print the file to a 
printer attached to the printer port of the terminal. 

This command uses the file /etc/termcap. 

Options 



Tells Iprint to use the standard input for printing. 

The variables LPR and PRINTER can each be set to ‘spooler’ or ‘local’. 
These variables let you send files to the spool printer or the terminal’s 
local printer, respectively. The file Aisr/bin/spool contains the 
‘spooler’ setting for both variables. The file /usr/bin/spool contains 
the ‘local’ setting. The following are a few examples of variable 
usage: 



Ip -option spooler 

LPR=local 

LPR=spooler 

spool Ip -option device file 



Fiies 



/etc/termcap 

/usr/bin/spool 

/usr/bin/local 
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Only certain terminals have entries in /etc/termcap with this capabil- 
ity already defined (for example, Tandy’s DT-100 and DT-1, and 
Hewlett-Packard’s HP-92). 

To add attached printer capability to the termcap file for a different 
terminal, add entries for PN (start printing) and PS (end printing) with 
the appropriate control or escape characters for your terminal. 

Terminal communications parameters (such as baud rate and parity) 
must be set up on the terminal by the user. 

See Also 



“Using Printers” in the System Administrator's Guide 

Value Added 



Iprint is an extension of AT&T System V provided by Altos UNIX 
System V. 
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Ipstat 

print information about status of LP print service 

Syntax 

Ipstat [ options J 

Description 



Ipstat prints information about the current status of the LP print ser- 
vice. 

If no options are given, then Ipstat prints the status of all requests 
made to lp(C) by the users. Any arguments that are not options are 
assumed to be request- ids (as returned by Ip), printers, or printer 
classes. Ipstat prints the status of such requests, printers, or printer 
classes. Options may appear in any order and may be repeated and 
intermixed with other arguments. Some of the keyletters below may 
be followed by an optional list that can be in one of two forms: a list 
of items separated from one another by a comma, or a list of items 
enclosed in double quotes and separated from one another by a comma 
and/or one or more spaces. For example: 

-u “userl, user2, user3” 

Specifying "all" after any keyletters that take "list" as an argument 
causes all information relevant to the keyletter to be printed. For 
example, the command 

Ipstat -o all 

prints the status of all output requests. 

-a [list] Print acceptance status (with respect to Ip) of destinations 
for requests [see accept(ADM)]. list is a list of intermixed 
printer names and class names; the default is all. 

-c [list] Print class names and their members, list is a list of class 
names; the default is all. 

-d Print the system default destination for Ip. 

-f [list] [-1] 

Print a verification that the forms in form-list are recog- 
nized by the LP print service. The -I option will list the 
form descriptions. 
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-o [list] [-1] 

Print the status of output requests, list is a list of intermixed 
printer names, class names, and request-ids\ the default is 
all. The -I option gives a more detailed status of the 
request. 

-p [list] [-D] [-1] 

Print the status of printers named in list. If the -D option is 
given, a brief description is printed for each printer in list. 
If the -1 option is given, a full description of each printer’s 
configuration is given, including the form mounted, the 
acceptable content and printer types, a printer description, 
the interface used, and so on. 

-r Print the status of the LP request scheduler. 

-s Print a status summary, including the system default desti- 

nation, a list of class names and their members, a list of 
printers and their associated devices, a list of all forms 
currently mounted, and a list of all recognized character 
sets and print wheels. 

‘SUist] [-1] 

Print a verification that the character sets or the print 
wheels specified in list are recognized by the LP print ser- 
vice. Items in list can be character sets or print wheels; the 
default for the list is all. If the -1 option is given, each line 
is appended by a list of printers that can handle the print 
wheel or character set. The list also shows whether the 
print wheel or character set is mounted or specifies the 
built-in character set into which it maps. 

-t Print all status information. 

-u [fo/] Print status of output requests for users. List is a list of log- 
in names. The default is all. 

-V [list] Print the names of printers and the path names of the de- 
vices associated with them, list is a list of printer names. 
The default is all. 

Files 



/usr/spool/lp/* 

See Also 



enable(C), lp(C) 
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Standards Conformance 



Ipstat is conformant with: 

AT&TSVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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Is 

gives information about contents of directories 

Syntax 



Is [ -ACFRabcdfgilmnopqrstux ] [ names ] 

Description 



For each directory named, Is lists the contents of that directory; for 
each file named, Is repeats its name and any other information 
requested. By default, the output is sorted alphabetically. When no 
argument is given, the current directory is listed. When several argu- 
ments are given, the arguments are first sorted appropriately, file argu- 
ments are processed before directories and their contents. 

There are three major listing formats. The default format is to list one 
entry per line, the -C and -x options enable multi-column formats, and 
the -m option enables stream output format in which files are listed 
across the page, separated by commas. In order to determine output 
format for the -C, -x, and -m options. Is uses an environment variable, 
COLUMNS, to determine the number of character positions available 
on one output line. If this variable is not set, the termcap database is 
used to determine the number of columns, based on the environment 
variable TERM. If this information cannot be obtained, 80 columns 
are assumed. 

There are many options: 

-A List all entries. Entries whose name begin with a period (.) are 
listed. Does not list current directory (.) and directory above 

c.). 

-a Lists all entries. Entries whose name begin with a period (.) are 
listed. 

-R Recursively lists subdirectories encountered. 

-d If an argument is a directory, lists only its name (not its con- 
tents); often used with -1 to get the status of a directory. 

-C Multi-column output with entries sorted down the columns. 

-X Multi-column output with entries sorted across rather than down 
the page. 
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-ni Stream output format. 

-1 Lists in long format, giving mode, number of links, owner, 
group, size in bytes, and time of last modification for each file 
(see below). If the file is a special file, the size field will contain 
the major and minor device numbers, rather than a size. 

-n The same as -1, except that the owner’s UID and group’s GID 
numbers are printed, rather than the associated character strings. 

-o The same as -1, except that the group is not printed. 

-g The same as -1, except that the owner is not printed. 

-r Reverses the order of sort to get reverse alphabetic or oldest 

first, as appropriate. 

-t Sorts by time modified (latest first) instead of by name. 

-u Uses time of last access instead of last modification for sorting 
use with the -t option. 

-c Uses time of last modification of the inode (file created, mode 
changed, etc.) for sorting use with -t option. 

-p Puts a slash (/) after each filename if that file is a directory. 

-F Puts a slash (/) after each filename if that file is a directory and 

puts an asterisk (*) after each filename if that file is executable. 

-b Forces printing of non-graphic characters to be in the octal \ddd 
notation. 

-q Forces printing of non-graphic characters in file names as the 
character (?). 

-i For each file, prints the inode number in the first column of the 
report. 

-s Gives size in blocks, including indirect blocks, for each entry. 

-f Forces each argument to be interpreted as a directory and lists 
the name found in each slot. This option turns off -1, -t, -s, and - 
r, and turns on -a. The order is the order in which entries appear 
in the directory. 
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The mode printed under the -I option consists of 1 1 characters. The 
first character is: 

If the entry is an ordinary file. 

d If the entry is a directory. 

b If the entry is a block special file. 

c If the entry is a character special file. 

p If the entry is a named pipe. 

s If the entry is a semaphore. 

m If the entry is a shared data (memory) file. 

The next 9 characters are interpreted as 3 sets of 3 bits each. The first 
set refers to the owner’s permissions; the next to permissions of others 
in the user-group of the file; and the last to all others. Within each set, 
the 3 characters indicate permission to read, to write, and to execute 
the file as a program, respectively. For a directory, “execute” permis- 
sion is interpreted to mean permission to search the directory for a 
specified file. 

The permissions are indicated as follows: 

r If the file is readable. 

w If the file is writable. 

X If the file is executable. 

If the indicated permission is not granted. 

The group-execute permission character is given as s if the file has 
set-group-ID mode; likewise, the user-execute permission character is 
given as s if the file has set-user-ID mode. The last character of the 
mode (normally x or -) is t if the 1000 (octal) bit of the mode is on. 
See chmodiC) for the meaning of this mode. The indications for set- 
ID and the 1000 bit of the mode are capitalized if the corresponding 
execute permission is not set. 

When the sizes of the files in a directory are listed, a total count of 
blocks including indirect blocks is printed. 
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/etc/passwd 


Gets user IDs for Is -1 and Is -o 


/etc/group 


Gets group IDs for Is -1 and Is -g 


/etc/termcap 


Gets terminal information 


See Also 




chmod(C), coltbl(M), find(C), 1(C), lc(C), locale(M), termcap(F) 

Notes 



Sorts according to the collating sequenced defined by the locale. 

Newline and tab are considered printing characters in filenames. 

Unprintable characters in filenames may confuse the columnar output 
options. 

This utility reports sizes in 512 byte blocks. Is -s interprets 1 block 
from a 1024 byte block system as 2 of its own 512 byte blocks. Thus a 
500 byte file is interpreted as 2 blocks rather than 1. 

Standards Conformance 



Is is conformant with: 

AT&TSVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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machid: 1386 

get processor type truth value 

Syntax 

B86 

Description 



If the machine is a 386, the iS86 command will return a true value 
(exit code of 0), otherwise it will return a false (non-zero) value. 
These type of commands are often used within makefiles [see 
make (CP)] and shell procedures [see ^/i(C)] to increase portability. 

See Aiso 



sh(C), test(C), true(C), make(CP) 
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mail 

interactive message processing system 

Syntax 

mail [ options ] [ name... ] 

Description 



mail provides a comfortable, flexible environment for sending and 
receiving messages electronically. For reading mail, mail provides 
commands to facilitate saving, deleting, and responding to messages. 
For sending mail, mail allows editing, reviewing, and other modifica- 
tion of the message as it is entered. 

Many of the remote features of mail will only work if the UUCP pack- 
age is installed on your system. 

Incoming mail is stored in a standard file for each user, called the 
mailbox for that user. When mail is called to read messages, the 
mailbox is the default place to find them. As messages are read, they 
are marked to be moved to a secondary file for storage, unless specific 
action is taken, so that the messages need not be seen again. This sec- 
ondary file is called the mbox and is normally located in the user’s 
HOME directory (see MBOX under Environment Variables). Mes- 
sages can be saved in other secondary files named by the user. Mes- 
sages remain in a secondary file until forcibly removed. 

The user can access a secondary file by using the -f option of the mail 
command. Messages in the secondary file can then be read or other- 
wise processed using the same commands as in the primary mailbox. 
This gives rise to the notion of a current mailbox. 

On the command line, options start with a dash (-) and any other argu- 
ments are taken to be destinations (recipients). If no recipients are 
specified, mail attempts to read messages from the mailbox. 
Command-line options are: 

■e Test for presence of mail, mail prints nothing and 

exits with a successful return code if there is mail 
to read. 

-f [filename] Read messages from filename instead of mailbox. 

If no filename is specified, the mbox is used. 
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-F 



-h number 



-H 

-i 



-n 



Record the message in a file named after the first 
recipient. Overrides the record variable, if set 
(see Environment Variables). 

The number of network “hops” made so far. 
This is provided for network software to avoid 
infinite delivery loops. (See addsopt under 
Environment Variables). 

Print header summary only. 

Ignore interrupts. (See ignore under Environ- 
ment Variables). 

Do not initialize from the system default mailrc 
file. 



-N 

-r address 



-s subject 
-u user 



-U 



Do not print initial header summary. 

Pass address to network delivery software. All 
tilde commands are disabled. (See addsopt under 
Environment Variables). 

Set the Subject header field to subject . 

Read user's mailbox. This is only effective if 
user's mailbox is not read protected. 

Convert uucp style addresses to internet stan- 
dards. Overrides the conv environment variable. 
(See addsopt under Environment Variables). 



When reading mail, mail is in command mode, A header summary of 
the first several messages is displayed, followed by a prompt indicat- 
ing mail can accept regular commands (see Commands below). When 
sending mail, mail is in input mode. If no subject is specified on the 
command line, a prompt for the subject is printed. (A subject longer 
than 1024 characters will cause mail to dump core.) As the message is 
typed, mail will read the message and store it in a temporary file. 
Commands may be entered by beginning a line with the tilde (~) 
escape character followed by a single command letter and optional 
arguments. See Tilde Escapes for a summary of these commands. 



At any time, the behavior of mail is governed by a set of environment 
variables. These are flags and valued parameters which are set and 
cleared via the set and unset commands. See Environment Variables 
below for a summary of these parameters. 

Recipients listed on the command line may be of three types: login 
names, shell commands, or alias groups. Login names may be any 
network address, including mixed network addressing. If mail is 
found to be undeliverable, an attempt is made to return it to the 
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sender’s mailbox. If the recipient name begins with a pipe symbol ( I ), 
the rest of the name is taken to be a shell command to pipe the mes- 
sage through. This provides an automatic interface with any program 
that reads the standard input, such as /p(C), for recording outgoing 
mail on paper. Alias groups are set by the alias command (see Com- 
mands below) and are lists of recipients of any type. 

Regular commands are of the form: 

[ command ] [ msglist ] [ arguments ] 

If no command is specified in command mode, print is assumed. In 
input mode, commands are recognized by the tilde escape character, 
and lines not treated as commands are taken as input for the message. 

Each message is assigned a sequential number, and there is at any 
time the notion of a current message, marked by a right angle bracket 
(>) in the header summary. Many commands take an optional list of 
messages (msglist) to operate on. The default for msglist is the current 
message. A msglist is a list of message identifiers separated by 
spaces, which may include: 



n 


Message number n. 


• 


The current message. 




The first undeleted message. 


$ 


The last message. 


* 


All messages. 


n-m 


An inclusive range of message numbers. 


user 


All messages from user. 


Istring 


All messages with string in the subject line (case 
ignored). 


:c 


All messages of type c, where c is one of: 
d deleted messages 



n new messages 
o old messages 
r read messages 
u unread messages 

Note that the context of the command determines whether this type 
of message specification makes sense. 

Other arguments are usually arbitrary strings whose usage depends on 
the command involved. File names, where expected, are expanded via 
the normal shell conventions [see sh(C)]. Special characters are 
recognized by certain commands and are documented with the com- 
mands below. 

At start-up time, mail tries to execute commands from the optional 
system-wide file (/usr/lib/mail/mailrc) to initialize certain parame- 
ters, then from a private start-up file ($HOME/.mailrc) for personal- 
ized variables. With the exceptions noted below, regular commands 
are legal inside start-up files. The most common use of a start-up file 
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is to set up initial display options and alias lists. The following com- 
mands are not legal in die start-up file: !, Copy, edit, forward. For- 
ward, hold, mail, preserve, reply. Reply, shell, and visual. An error 
in the start-up file causes the remaining lines in the file to be ignored. 
The .mailrc file is optional and must be constructed locally. 



Commands 

The following is a complete list of mail commands: 

Ishell-command 

Execute shell command and return. (See SHELL under Environ- 
ment Variables). 

# comment 

Null command (comment). This may be useful in .mailrc files. 



Print the current message number. 



9 

Print a summary of commands. 

alias alias name ... 
group alias name ... 

Declare an alias for the given names. The names will be substi- 
tuted when alias is used as a recipient. Useful in the .mailrc file. 

alternates name ... 

Declare a list of alternate names for your login. When responding 
to a message, these names are removed from the list of recipients 
for the response. With no arguments, alternates prints the current 
list of alternate names. (See allnet under Environment Variables). 

cd [directory] 
chdir [directory] 

Change directory. If directory is not specified, $HOME is used. 

copy [filename] 
copy [msglist] filename 

Copy messages to the file without marking the messages as saved. 
Otherwise equivalent to the save command. 

Copy [msglist] 

Save the specified messages in a file whose name is derived from 
the author of the message to be saved, without marking the mes- 
sages as saved. Otherwise equivalent to the Save command. 
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delete [msglist] 

Delete messages from the mailbox. If autoprint is set, the next 
message after the last one deleted is printed (see Environment 
Variables). 

discard [header-field ...] 
ignore [header-field ...] 

Suppress printing of the specified header fields when displaying 
messages on the screen. Examples of header fields to ignore are 
“status” and “cc”. The fields are included when the message is 
saved. The Print and Type commands override these commands. 

dp [msglist] 
dt [msglist] 

Delete the specified messages from the mailbox and print the next 
message after the last one deleted. Roughly equivalent to a delete 
command followed by a print command. 

echo string ... 

Echo the given strings [like echo(C)]. 
edit [msglist] 

Edit the given messages. The messages are placed in a temporary 
file and the EDITOR variable is used to get the name of the editor 
(see Environment Variables). Default editor is ed(C). 

exit 

xit 

Exit from mail without changing the mailbox. No messages are 
saved in the mbox (see also quit). 

file [filename] 
folder [filename] 

Quit from the current file of messages and read in the specified file. 
Several special characters are recognized when used as file names, 
with the following substitutions: 

% the current mailbox. 

%user the mailbox for user. 

# the previous file. 

& the current mbox. 

Default file is the current mailbox. 

folders 

Print the names of the files in the directory set by the folder vari- 
able (see Environment Variables). 

forward [message] name ... 

Forward the specified message to the specified users, shifting the 
forwarded text to the right one tab stop. 
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Forward [message] name ... 

Forward the specified message to the specified users, with no 
indentation. 

from [msglist] 

Prints the header summary for the specified messages. 

group alias name ... 

See alias. 

headers [+1-1 msglist] 

Lists the current range of headers. The screen variable sets the 
number of headers per page (see Environment Variables). If a “+” 
argument is given, then the next page is printed, and if a argu- 

ment is given, the previous page is printed. Both “+” and can 
take a number to view a particular window. If a message list is 
given, it prints the specified headers, disregarding all windowing. 
See also the z command. 

help 

Prints a summary of commands. 

hold [msglist] 
preserve [msglist] 

Holds the specified messages in the mailbox. 
if s\r 

mail-commands 

else 

mail-commands 

endif 

Conditional execution, where s causes the first mail commands, up 
to an else or endif to be executed if the program is in send mode, 
and r causes the mail commands to be executed only in receive 
mode. The mail-commands after the else are executed if the pro- 
gram is in the opposite mode from the one indicated. Useful in the 
.mailrc file. 

ignore header-field ... 
discard header-field ... 

Suppresses printing of the specified header fields when displaying 
messages on the screen. Examples of header fields to ignore are 
“status” and “cc”. All fields are included when the message is 
saved. The Print and Type commands override this command. 



list 

Prints all commands available. No explanation is given. 
Ipr [msglist] 

Print the specified messages on the lineprinter. 
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mail name ... 

Mail a message to the specified users. 

Mail name 

Mail a message to the specified user and record a copy of it in a file 
named after that user. 

mbox [msglist] 

Arrange for the given messages to end up in the standard mbox 
save file when mail terminates normally. See the exit and quit 
commands. 

next [message] 

Go to next message matching message. A msglist may be 
specified, but in this case the first valid message in the list is the 
only one used. This is useful for jumping to the next message from 
a specific user, since the name would be taken as a command in 
the absence of a real command. See the discussion of msglists 
above for a description of possible message specifications. 

pipe [msglist] [shell-command] 

I [msglist] [shell-command] 

Pipe the message through the given shell-command. The message 
is treated as if it were read. If no arguments are given, the current 
message is piped through the command specified by the value of 
the cmd variable. If the page variable is set, a form feed character 
is inserted after each message (see Environment Variables). 

preserve [msglist] 

See hold. 

Print [msglist] 

Type [msglist] 

Print the specified messages on the screen, including all header 
fields. Overrides suppression of fields by the ignore command. 

print [msglist] 
type [msglist] 

Print the specified messages. If crt is set, the messages longer than 
the number of lines specified by the crt variable are paged through 
the command specified by the PAGER variable. The default com- 
mand is more{C) (see Environment Variables). 

quit 

Exit from mail, storing messages that were read in mbox and 
unread messages in the mailbox. Messages that have been explic- 
itly saved in a file are deleted from the mailbox. 

Reply [msglist] 

Respond [msglist] 

Reply to the specified message, including all other recipients of the 
message. If record is set to a file name, the response is saved at 
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the end of that file (see Environment Variables). 

reply [message] 
respond [message] 

Send a response to the author of each message in the msglist. The 
subject line is taken from the first message. If record is set to a 
file name, the response is saved at the end of that file (see Environ- 
ment Variables). 

Save [msglist] 

Save the specified messages in a file whose name is derived from 
the author of the first message. The name of the file is taken to be 
the author’s name with all network addressing stripped off. See 
also the Copy commands and outfolder (Environment Variables). 

save [filename] 
save [msglist] filename 

Save the specified messages in the given file. The file is created if 
it does not exist. The message is deleted from the mailbox when 
mail terminates unless keepsave is set (see also Environment Vari- 
ables and the exit and quit commands). 



set 

set name 

set name=string 

set name-number 

Define a variable called name. The variable may be given a null, 
string, or numeric value. Set by itself prints all defined variables 
and their values. See Environment Variables for detailed descrip- 
tions of the mail variables. 

shell 

Invoke an interactive shell (see SHELL under Environment Vari- 
ables). 

size [msglist] 

Mnt the size in characters of the specified messages, 
source filename 

Read commands from the given file and return to command mode, 
top [msglist] 

Mnt the top few lines of the specified messages. If the toplines 
variable is set, it is taken as the number of lines to print (soe 
Environment Variables). The default is 5. 

touch [msglist] 

Touch the specified messages. If any message in msglist is not spe- 
cifically saved in a file, it will be placed in the mbox, or the file 
specified in the MBOX environment variable, upon normal termi- 
nation. See exit and quit. 
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Type [msglist] 

See Print. 

type [msglist] 

See print. 

undelete [msglist] 

Restore the specified deleted messages. Will only restore mes- 
sages deleted in the current mail session. If autoprint is set, the 
last message of those restored is printed (see Environment Vari- 
ables). 

unset name ... 

Causes the specified variables to be erased. If the variable was 
imported from the execution environment (i.e., a shell variable), 
then it cannot be erased. 

version 

Prints the current version and release date, 
visual [msglist] 

Edit the given messages with a screen editor. The messages are 
placed in a temporary file and the VISUAL variable is used to get 
the name of the editor (see Environment Variables). 

write [msglist] filename 

Write the given messages on the specified file, minus the header 
and trailing blank line. Otherwise equivalent to the save com- 
mand. 



xit 

See exit. quit). 



z[+l-l 

Scroll the header display forward or backward one full screen. The 
number of headers displayed is set by the screen variable (see 
Environment Variables). 



Tilde Escapes 

The following commands may be entered only from input mode, by 
beginning a line with the tilde escape character (~). See escape under 
Environment Variables for changing this special character. 

“! shell-command 

Execute the shell command and return. 



Simulate end of file (terminate message input). 
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: command 
_ command 

Perform the command-level request. Valid only when sending a 
message while reading mail. 



Print a summary of tilde escapes. 

~A 

Insert the autograph string Sign into the message (see Environment 
Variables). 

'a 

Insert the autograph string sign into the message (see Environment 
Variables). 

“'b name ... 

Add the names to the blind carbon copy (Bcc) list. 

"c name ... 

Add the names to the carbon copy (Cc) list. 

Read in the dead. letter file. (See DEAD under Environment Vari- 
ables for a description of this file.) 



Invoke the editor on the partial message. (See EDITOR under 
Environment Variables.) 

[msglist] 

Forward the specified messages. The messages are inserted into 
the message without alteration. 



~h 

Prompt for Subject line and To, Cc, Bcc, and Retum-Receipt-to 
lists. If the field is displayed with an initial value, it may be edited 
as if you had just typed it. 

~i variable 

Insert the value of the named variable into the text of the message. 
For example, 'A is equivalent to ’"i Sign.’ Environment variables 
set and exported in the shell are also accessible by "'i. 

"M [msglist] 

Insert the specified messages into the letter, with no indentation. 
Valid only when sending a message while reading mail. 

“m [msglist] 

Insert the specified messages into the letter, shifting the new text 
to the right one tab stop. Valid only when sending a message while 
reading mail. 
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P 

Print the message being entered. 

q 

Quit from input mode by simulating an interrupt. If the body of the 
message is not null, the partial message is saved in dead.letter. 
(See DEAD under Environment Variables). 

r filename 
filename 

”< \shell-command 

Read in the specified file. If the argument begins with an exclama- 
tion point (!), the rest of the string is taken as an arbitrary shell 
command and is executed, with the standard output inserted into 
the message. 



s string ... 

Set the subject line to string. 



t name ... 

Add the given names to the To list. 



Invoke a preferred screen editor on the partial message. (See also 
VISUAL under Environment Variables.) 



w filename 

Write the partial message onto the given file, without the header. 



X 

Exit as with “q except the message is not saved in dead.letter. 



I shell-command 

Pipe the body of the message through the given shell-command. If 
the shell-command returns a successful exit status, the output of 
the command replaces the message. 



Environment Variables 

The following are environment variables taken from the execution 
environment and are not alterable within mail. 

HOME-directory 

The user’s base of operations. 
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MAllMQ=filename 

The name of the start-up file. Default is $HOME/.mailrc. 

The following variables are internal mail variables. They may be 
imported from the execution environment or set via the set command 
at any time. The unset command may be used to erase variables. 

addsopt 

Enabled by default. If /bin/mail is not being used as the deliverer, 
noaddsopt should be specified. (See Notes below) 

allnet 

All network names whose last component (login name) match are 
treated as identical. This causes the msglist message specifica- 
tions to behave similarly. Default is noallnet. See also the alter- 
nates command and the metoo variable. 

append 

Upon termination, append messages to the end of the mbox file 
instead of prepending them. Default is noappend. 

askcc 

Prompt for the Cc list after message is entered. Default is 
noaskcc. 

asksub 

Prompt for subject if it is not specified on the command line with 
the -s option. Enabled by default. 

autoprint 

Enable automatic printing of messages after delete and undelete 
commands. Default is noautoprint. 

bang 

Enable the special-casing of exclamation points (!) in shell escape 
command lines as in v/(C). Default is nobang. 

chron 

Causes messages to be displayed in chronological order. The 
default is reverse chronological order (most recent message first). 
See also mchron below. 

cmd=shell-command 

Set the default command for the pipe command. Not set by 
default. 

coii\=conversion 

Convert uucp addresses to the specified address style. The only 
valid conversion now is internet, which requires a mail delivery 
program conforming to the RFC822 standard for electronic mail 
addressing. Conversion is disabled by default. See also the send- 
mail variable and the -U command-line option. 
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cri=number 

Pipe messages having more than number lines through the com- 
mand specified by the value of the PAGER variable (more(C) by 
default). Disabled by default. 

DEAD=filename 

The name of the file in which to save partial letters in case of 
untimely interrupt. Default is $HOME/dead. letter. 

debug 

Enable verbose diagnostics for debugging. Messages are not 
delivered. Default is nodebug. 



dot 

Take a period on a line by itself during input from a terminal as 
end-of-file. Default is nodot. 

EDlTOR=shell-command 

The command to run when the edit or ~e command is used. Default 
is ed(C). 

escape=c 

Substitute c for the escape character. Takes effect with next mes- 
sage sent. 

folder=directory 

The directory for saving standard mail files. User- specified file 
names beginning with a plus (+) are expanded by preceding the file 
name with this directory name to obtain the real file name. If 
directory does not start with a slash (/), $HOME is prepended to it. 
In order to use the plus (+) construct on a mail command line, 
folder must be an exported sh environment variable. There is no 
default for the folder variable. See also outfolder below. 

header 

Enable printing of the header summary when entering mail. 
Enabled by default. 

hold 

Preserve all messages that are read in the mailbox instead of put- 
ting them in the standard mbox save file. Default is nohold. 

ignore 

Ignore interrupts while entering messages. Handy for noisy dial- 
up lines. Default is noignore. 

ignoreeof 

Ignore end-of-file during message input. Input must be terminated 
by a period (.) on a line by itself or by the command. Default is 
noignoreeof. See also the dot variable above. 
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keep 

When the mailbox is empty, truncate it to zero length instead of 
removing it. Disabled by default. 

keepsave 

Keep messages that have been saved in other files in the mailbox 
instead of deleting them. Default is nokeepsave. 

MROX-filename 

The name of the file to save messages which have been read. The 
xit command overrides this function, as does saving the message 
explicitly in another file. Default is $HOME/mbox. 

mchron 

Causes message headers to be listed in numerical order (most 
recently received first), but displayed in chronological order. See 
also chron above. 

metoo 

If your login appears as a recipient, do not delete it from the list. 
Default is nometoo. 

lAST¥R=shell-command 

The command (and options) to use when listing the contents of the 
folder directory. The default is ls{C). 

onehop 

When responding to a message that was originally sent to several 
recipients, the other recipient addresses are normally forced to be 
relative to the originating author’s machine for the response. This 
flag disables alteration of the recipients’ addresses, improving 
efficiency in a network where all machines can send directly to all 
other machines (i.e., one hop away). 

outfolder 

Record outgoing messages in files located in the directory 
specified by the folder variable unless the path name is absolute. 
Default is nooutfolder. See the folder variable above and the 
Save and Copy commands. 

page 

Used with the pipe command to insert a form feed after each mes- 
sage sent through the pipe. Default is nopage. 

VkGER=shell-command 

Use shell-command as a filter for paginating output. This can also 
be used to specify the options to be used. Default is more(C), 

prompt=string 

Set the command mode prompt to string. Default is ? . 
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quiet 

Refrain from printing the opening message and version when 
entering mail. Default is noquiet. 

record=/I/^/u2m^ 

Record all outgoing mail in filename. Disabled by default. See 
also outfolder above. 

save 

Enable saving of messages in dead. letter on interrupt or delivery 
error. See DEAD for a description of this file. Enabled by default. 

SQTttn=number 

Sets the number of lines in a full screen of headers for the headers 
command. 

stii&m 2 Li\=shell-command 

Alternate command for delivering messages. Default is 
lbinlrmail(C). 

sendwait 

Wait for background mailer to finish before returning. Default is 
nosendwait. 

SHELL=shell-command 

The name of a preferred command interpreter. Default is sh(C). 
showto 

When displaying the header summary and the message is from you, 
print the recipient’s name instead of the author’s name. 

sign=string 

The variable inserted into the text of a message when the "a (auto- 
graph) command is given. Not set by default (see 'i under Tilde 
Escapes). 

Sign=string 

The variable inserted into the text of a message when the “A com- 
mand is given. Not set by default (see also "i under Tilde Escapes). 

top\ines=number 

The number of lines of header to print with the top command. 
Default is 5. 

\lSlJAL=shell-command 

The name of a preferred screen editor. Default is v/(C). 
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$HOME/.mailrc personal start-up file 

$HOME/mbox secondary storage file 

/usr/spool/mail post office directory 

/usrAib/mail/mail.help* help message files 
/usrAib/mail/mailrc optional global start-up file 

/tmp/R[emqsx]* temporary files 



See Also 



ls(C), mail(C), more(C) 

Notes 



The -h, -r and -U options can be used only if mail is built with a 
delivery program other than f bin! mail. 

Where shell-command is shown as valid, arguments are not always 
allowed. Experimentation is recommended. 

Internal variables imported from the execution environment cannot be 
unset. 

The full internet addressing is not fully supported by mail. The new 
standards need some time to settle down. 

A line consisting only of a is treated as the end of the message. 

Standards Conformance 



mail is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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man 

prints reference pages in this guide 
Syntax 



man [-afbcw] [-iproc] pager ^ [-ddir] [-T/erm] 
[section] [title] 

/usr/lib/manprog file 

Description 



The man program locates and prints the named title from the desig- 
nated reference section. For historical reasons, “page” is often used 
as a synonym for “entry” in this context. 

Since Altos UNIX System V commands are given in lowercase, the 
title is always entered in lowercase. If no section is specified, the 
whole guide is searched for title and the first occurrence of it is 
printed. You can search for a group of sections by separating the sec- 
tion names with colons ( : ) on the command line. 

The options and their meanings are: 

-a “All” mode. Displays all matching titles. Incompatible 

with the -f option. 

-f “First” mode. Displays only the first matching title. 

Incompatible with -a option. This is the default mode for 
man(C). 

-b Leaves blank lines in output, nroff pads entries with blank 

lines for line printer purposes, man normally filters out 
these excess blank lines. Normally, man does not display 
more than 2 consecutive blank lines. The -b flag leaves 
blank lines in the CRT output. 

-c Causes man to invoke col(C). Note that col is invoked 

automatically by man unless term is one of the follow- 
ing: 300, 300s, 450, 37, 4000a, 382, 4014, tek, 1620, and 
X. 

-w Prints on the standard output only the pathnames of the 

entries. 
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•iproc Indicates that if an unprocessed manual page is available, 
it is to be passed to proc for formatting, proc can be any 
command script in lusrimanibin or an absolute filename of 
a text processing program elsewhere on the system, for 
example Ibininroff. 

The scripts in lusrimanibin invoke the actual processing 
programs with the correct flags and arguments. The 
default processor is lusrimanibininr, which invokes 
Ibininroff Bind produces output that safely prints on any 
terminal. The text is also preprocessed by eqn and tbl as a 
default. Note that the operating system does not include 
these formatting programs; you must install them yourself 
or specify alternatives with the -t option. 

-ppager Selects paging program pager to display the entry. Paging 
systems such as more(C), pg(C), cat(C), or any custom 
pagers that you may have are valid arguments for this 
flag. The default pager, pg(C), is set in ! etc! default! man. 



-ddir Specifies directory dir to be added to the search path for 
entries. You can specify several directories to be 
searched by separating the directory names with colons 
( : ) on the command line. 

-Tterm Format the entry and pass the given term value to the pro- 
cessing program, then print it on the standard output (usu- 
ally, the terminal), where term is the terminal type (see 
term(M) and the explanation below). 



Section Names 

The names and general descriptions of the available manual sections 
are: 

ADM System Administration 

C Commands 

M Miscellaneous 

F File Formats 

HW Hardware Dependent 

S Subroutines and Libraries 

CP Programming Commands 

DOS DOS Subroutines and Libraries 

K Kernel Routines 

NSL Network Services Library 

STR STREAMS 

XNX XENIX Cross-development 
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LOCAL Local utilities for your system 

You can add other section names as you desire. Each new section, 
however, must follow the standard section directory structure. The 
LOCAL directory is shipped without contents, as no LOCAL manual 
pages are includ^. 

/usr/man Directory Structure 



The source files for the man(C) program are kept in the directory 
lusriman. Each man section is comprised of two directories, and there 
is a directory called bin for programs and shell scripts related to 
man(C). There is also an index file called index in lusriman. This 
index is a list of all Altos UNIX System V commands and their sec- 
tions. 

Each manual section has two directories in lusriman. These directories 
are called man and cat, plus the name of the section as a suffix. For 
example, the C manual section is comprised of two directories, man.C 
and cat.C, both located in lusriman. 

The unprocessed source text is in the man directory and the printable 
processed output is in the cat directory. When a title is requested, both 
directories are checked. The most recent copy of the manual page is 
used as the current copy. If the most recent title is in the source text 
directory and it is processed by the default processor with the default 
terminal type, a display copy of the output is placed in the cat direc- 
tory for future use. Note that a file that must be processed takes longer 
to appear on the screen than a display copy. 



Environment Variables 

There is a shell environment variable for use with the man(C) utility. 
This variable is called MANPATH and it is used to change or aug- 
ment the path man(C) searches for entries. Multiple directories set 
with this variable must be delimited by colon characters ( : ). If the 
MANPATH environment variable is present, the directories are 
searched in the order that they appear, lusriman must appear in the 
MANPATH list to be included. If you set this environment variable, 
it supersedes the MANPATH entry in the letcldefaultiman file. Alter- 
nate subdirectories are expected to have the same form as the default 
directories in lusriman. 



/etc/default/man 

There is a file called man in the letcl default directory that contains the 
default settings for the man utility. The following options are set in 
letcldefaultiman: 
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PAGER=/usr/bin/pg 

MANPATH=/usr/man 

TERM=lp 

ORDER=ADM : C : S : CP : M : F : HW : DOS : LOCAL 

MODE=FIRST 

PROC=nr 

You can select a different paging system, search path, terminal type, 
search order, mode, and processor for the man(C) system by changing 
the information in this file. 

To change the search order for manual sections, edit the list following 
the ORDER variable. Be certain the section names are separated with 
colons ( : ). Section names not present in ORDER are searched in arbi- 
trary order after those specified in ! etc! default! man. 



Creating New Manual Entries 

You can create new manual pages for utilities and scripts that you 
have developed. Use an existing manual page as an example of manu- 
al page structure. Use the man macros to format your manual page. 
Note that the operating system does not include nroff and the related 
family of formatting utilities. You must install them separately or 
specify another formatter with the -t option. 

You must be logged in as root (the “Super-User”) to place a new 
manual page in your lusriman directory structure. Place your new 
page in lusrImanIman.LOCAL while logged in as root and view it 
using the man(C) command, since only root has write permission for 
the cat-able directories. Once man has produced the cat- able output, 
any user can view the new page in the same manner as any other on 
line manual page. 

Additionally, you can create your own custom sections by creating 
another manual directory and putting it in the MANPATH. For exam- 
ple, if subdirectories manX and catX are present, then man(C) recog- 
nizes that X is a valid manual section. 

If you wish to use another text processing program (such as troff to 
process your custom manual pages, use the -tproc flag of man. proc 
can be any shell script in lusrimanibin. To place a cat-able copy of the 
manual page in the cat directory, use the tee(C) command to send the 
output to a file, as well as to the standard output. Your command 
should have the form: 

man -tproc filename I tee pathname 

In the above example, proc is the text processing script, filename is the 
manual page source file, and pathname is the path of the directory for 
the cat-able output. 
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Custom manual sections can have an index, if the format is the same 
as the index in lusriman. man(C) uses the index to locate multiple 
commands that are listed on the same page as well as commands that 
have pages in several different sections. 



The man Macro Package 

The man macro package is located in lusrilibi macros! an. It is 
included for use with the nroff/troff formatting package, which must 
be separately installed. There are 15 basic macros in the package. 
Here is a table of the macros and brief descriptions of their functions: 



Macro 


Description 


.TH title 


Title Heading 


.SH title 


Section Heading 


.SS title 


Subsection Heading 


.SM text 


Reduce Point Size 


.PP 


New Paragraph 


.IP 


Indented Paragraph 


.HP 


Hanging Paragraph 


.TP 


Tagged Paragraph 


.RS n 


Relative Indent 


.RE 


Release Relative Indent 


.1 text 


Italic Font 


.B text 


Bold Font 


.R text 


Roman Font 


.PM 


Proprietary Mark (copyright) 



See Also 



environ(M), term(F) 

Notes 



All entries are supposed to be reproducible either on a typesetter or on 
a terminal. However, on a terminal some information, such as eqn 
and tbl output, is either lost or approximated as it cannot be exactly 
reproduced. 
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mesg 

permits or denies messages sent to a terminal 

Syntax 

mesg [ n H y ] 

Description 



mesg with argument n forbids messages via write (C) by revoking 
nonuser write permission on the user’s terminal, mesg with argument 
y reinstates permission. All by itself, mesg reports the current state 
without changing it. 

Fiies 



/dev/tty* 

See Also 



write(C) 

Diagnostics 



Exit status is 0 if messages are receivable, 1 if not, 2 on error. 

Standards Conformance 



mesg is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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mkdir 

makes a directory 

Syntax 

mkdir [ -m mode ] [ -p] dimame ... 

Description 



The mkdir command creates the named directories in mode 111 [pos- 
sibly altered by umask{C)\. 

Standard entries in a directory (e.g., the files for the directory itself, 
and for its parent) are made automatically, mkdir cannot create 
these entries by name. Creation of a directory requires write permis- 
sion in the parent directory. 

The owner ID and group ID of the new directories are set to the pro- 
cess’s real user ID and group ID, respectively. 

Two options apply to mkdir : 

-m This option allows users to specify the mode to be used for new 
directories. Choices for modes can be found in chmod(C). 

-p With this option, mkdir creates dirname by creating all the non- 
existing parent directories first. 

See Also 



sh(C), rm(C), rmdir(C), umask(C), mkdir(S) 

Diagnostics 



The mkdir command returns exit code 0 if all directories given in the 
command line were made successfully. Otherwise, it prints a diagnos- 
tic and returns non-zero. An error code is stored in errno . 

Standards Conformance 



mkdir is conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 
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mknod 

builds special files 

Syntax 

/etc/mknod name [ c 1 b ] major minor 
/etc/mknod name p 
/etc/mknod name s 
/etc/mknod name m 

Description 



mknod makes a directory entry and corresponding inode for a special 
file. The first argument is the name of the entry. In the first case, the 
second argument is b if the special file is block-type (disks, tape) or c 
if it is character-type (other devices). The last two arguments are 
numbers specifying the major device type and the minor device (e.g., 
unit, drive, or line number), which may be either decimal or octal. 

The assignment of major device numbers is specific to each system. 
Major device numbers can be found in the system source file 
/etc/conf/cf.d/mdevice. 

mknod can also be used to create named pipes with the p option, 
semaphores with the s option, and shared data (memory) with the m 
option. 

Only the super-user can use the first form of the syntax. 

See Also 



mknod(S) 

Standards Conformance 



mknod is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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mnt, umnt 

mount a filesystem 

Syntax 

/usr/bin/mnt [ -urat ] [ directory ] 
/usr/bin/umnt directory 

Description 



mnt allows users other than the super-user to access the functionality 
of the mount{MyM) command to mount selected filesystems. The 
super-user can define how and when a filesystem mount is permitted 
via special entries in the /etc! default/ filesys file. 

The filesystem requirements are the same as defined for mount{ADM). 

umnt removes the mountable filesystem previously mounted in direc- 
tory . 

mnt is invoked from the letcirc scripts with the -r and possibly the -a 
flag to mount filesystems when the system comes up multiuser. The 
-a flag is used when the system has autobooted. Neither of these flags 
should be specified during normal use. 

The -t flag displays the contents of /etc/default/filesys. 

The -u flag forces mnt to behave like umnt. 

Options 



The following options can be defined in the /etc! default/ filesys entry 
for a filesystem: 



bdev=/dev/(i^v/ce Name of block device associated with the 
filesystem. 



cdev=/dev/(i^v/c^ Name of character (raw) device associated 
with the filesystem. 

mountdir=l directory The directory the filesystem is to be mounted 

on. 
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dtsc-name A string describing the filesystem. 

passwd=^?rmg An optional password prompted for at mount 

request time. Cannot he a simple string; must 
be in the format of /etc/passwd. (See Notes.) 

fsck=yes, no, dirty, prompt 

If yes/no, tells explicitly whether or not to run 
fsek. If dirty, fsck is run only if the filesystem 
requires cleaning. If prompt, the user is 
prompted for a choice. If no entry is given, 
the default value is dirty. 

fsckflags=/?ag^ Any flags to be passed to fsck. 

rcfsck=yes, no, dirty, prompt 

Similar to fsck entry, but only applies when 
the -r flag is passed. 

maxcleans =/2 The number of times to repeat cleaning of a 

dirty filesystem before giving up. If 
undefined, default is 4. 

mount=yes, no, prompt 

If yes or no, users are allowed or disallowed 
to mount the filesystem, respectively. If 
prompt, the user specifies whether the filesys- 
tem should be mounted. 

rcmount=yes, no, prompt 

If yes, the filesystem is mounted by Ietclrc2 
when the system comes up multiuser. If no, 
the filesystem is never mounted by Ietclrc2. 
With prompt, a query is displayed at boot 
time to mount the filesystem. 

mountflags=/7ag^ Any flags to be passed to mount. 

prep=yes, no, prompt Indicates whether any prepemd entry should 
always be executed, never executed, or exe- 
cuted as specified by user. 

pTQpcmd=command An arbitrary shell command to be invoked 
immediately following password check and 
prior to mnning fsck. 

init=yes, no, prompt Indicates whether an initemd entry should 
always be executed, never be executed, or 
executed as specified by user. 
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m\icmd=command An optional, arbitrary shell command to be 
invoked immediately following a successful 
mount. 

Any entries containing spaces, tabs, or newlines must be contained in 
double quotes (”). 

The only mandatory entries in / etc! default! filesys are bdev and 
mountdir. The prepcmd and initcmd options can be used to execute 
another command before or after mounting the filesystem. For exam- 
ple, initcmd could be defined to send mail to root whenever a given 
filesystem is mounted. 

When invoked without arguments, mnt attempts to mount all filesys- 
tems that have the entries mount =yes or mount=prompt. 

Examples 



The following is a sample i etc! default! filesys file: 

bdev^ /dev/root cdev=/dev/rroot inountdir=/ \ 
desc="The Root Filesystem” rcmount=no mount=no 

bdev=/dev/u cdev=/dev/ru mountdi2:=/u rciTiount=yes \ 
fsckflags=-y desc="The User Filesystem” 

bdev=/dev/x cdev^/dev/rx mountdir=/u rcmount=no \ 
mount=yes fsckflags=-y desc=”The Extra Filesystem” 



Of the examples above, only !x is mountable by the user. 

Files 



/etc/default/filesys Filesystem data 

See Also 



mount(ADM), default(F) 

Diagnostics 



mnt will fail if the filesystem to be mounted is currently mounted 
under another name. 

Busy filesystems cannot be unmounted with umnt. A filesystem is busy 
if it contains an open file or if a user’s present working directory 
resides within the filesystem. 



March 11, 1990 



MNT-3 







MNT (C) 

Notes 



MNT(C) 



Some degree of validation is done on the filesystem, however it is gen- 
erally unwise to mount corrupt filesystems. 

In order to create a password for a filesystem, the system administrator 
must run the passwd(C) command using the -f option. 

Value Added 



mnt is an extension of AT&T System V provided by Altos UNIX Sys- 
tem V. 
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more 

views a file one screen full at a time 

Syntax 

more [ -cdflsuvw ][-«)[ +linenumber ] [ +/pattem ] [ name ... ] 

Description 



This filter allows examination of a continuous text one screen full at a 

time. It normally pauses after each full screen, displaying: 

— More— 

at the bottom of the screen. If the user then presses a carriage return, 

one more line is displayed. If the user presses the SPACE bar, another 

full screen is displayed. Other possibilities are described below. 

The command line options are: 

-72 An integer which is the size (in lines) of the window which more 
will use instead of the default. 

-c more draws each page by beginning at the top of the screen and 
erasing each line just before it draws on it. This avoids scrolling 
the screen, making it easier to read while more is writing. This 
option is ignored if the terminal does not have the ability to clear 
to the end of a line. 

-d more prompts with the message “Hit space to continue, Rubout to 
abort” at the end of each full screen. This is useful if more is being 
used as a filter in some setting, such as a class, where many users 
may be inexperienced. 

-f This option causes more to count logical, rather than screen lines. 
That is, long lines are not folded. This option is recommended if 
nrojf output is being piped through ul, since the latter may generate 
escape sequences. These escape sequences contain characters that 
would ordinarily occupy screen positions, but do not print when 
they are sent to the terminal as part of an escape sequence. Thus 
more may think that lines are longer than they actually are and fold 
lines erroneously. 

-1 Does not treat Ctrl-L (form feed) specially. If this option is not 
given, more pauses after any line that contains a Ctrl-L, as if the 
end of a full screen has been reached. Also, if a file begins with a 
form feed, the screen is cleared before the file is printed. 
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-s Squeezes multiple blank lines from the output, producing only one 
blank line. Especially helpful when viewing nroff output, this 
option maximizes the useful information present on the screen. 

-u Normally, more handles underlining, such as that produced by nroff 
in a manner appropriate to the particular terminal: if the terminal 
can perform underlining or has a stand-out mode, more outputs ap- 
propriate escape sequences to enable underlining or stand-out 
mode for underlined information in the source file. The -u option 
suppresses this processing. 

-V Normally, more ignores control characters that it does not interpret 
in some way. The -v option causes these to be displayed as "C 
where C is the corresponding printable ASCII character. Non- 
printing non- ASCII characters (with the high bit set) are displayed 
in the format M-C, where C is the corresponding character without 
the high bit set. If output is not going to a terminal, more does not 
interpret control characters. 

-w Normally, more exits when it comes to the end of its input. With - 
w however, more prompts and waits for any key to be struck before 
exiting. 

+linenumber 

Starts up at linenumber. 

+lpattern 

Starts up two lines before the line containing the regular expres- 
sion pattern, 

more looks in the file /etc/termcap to determine terminal characteris- 
tics, and to determine the default window size. On a terminal capable 
of displaying 24 lines, the default window size is 22 lines. 

more looks in the environment variable MORE to preset any flags 
desired. For example, if you prefer to view files using the -c mode of 
operation, the shell command “MORE=-c” in the .profile file causes 
all invocations of more to use this mode. 

If more is reading from a file, rather than a pipe, a percentage is dis- 
played along with the “—More—” prompt. This gives the fraction of 
the file (in characters, not lines) that has been read so far. 

Other sequences which may be entered when more pauses, and their 
effects, are as follows {i is an optional integer argument, defaulting to 
1 where not specified otherwise): 

i <space> 

Displays i more lines, (or another full screen if no argument is 
given). 
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Ctrl-D 

Displays 11 more lines (a '‘scroll”). If i is given, then the scroll 
size is set to i . 

d Same as Ctrl-D. 

iz Same as entering a space except that /, if present, becomes the 
new window size. 

i s Skips i lines and displays a full screen of lines. 

i f Skips i full screens and displays a full screen of lines. 

qorQ 

Exits from more. 

= Displays the current line number. 

V Starts up the screen editor vz at the current line. Note that vi may 
not be available with your system. 

h or ? 

Help command; Gives a description of all the more commands. 
i /expr 

Searches for the i th occurrence of the regular expression expr. If 
there are less than i occurrences of expr, and the input is a file 
(rather than a pipe), then the position in the file remains 
unchanged. Otherwise, a full screen is displayed, starting two 
lines before the place where the expression was found. The user’s 
erase and kill characters may be used to edit the regular expres- 
sion. Erasing back past the first column cancels the search com- 
mand. 

in Searches for the zth occurrence of the last regular expression 
entered. 

’ (Single quotation mark) Goes to the point from which the last 
search started. If no search has been performed in the current file, 
this command goes back to the beginning of the file. 

\ command 

Invokes a shell with command. The characters % and ! in “com- 
mand” are replaced with the current filename and the previous 
shell command respectively. If there is no current filename, % is 
not expanded. The sequences “\%” and “\!” are replaced by 
and “!” respectively. 

i :n 

Skips to the i th next file given in the command line (skips to last 
file if i doesn’t make sense). 
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/:p 

Skips to the i th previous file given in the command line. If this 
command is given in the middle of printing out a file, more goes 
back to the beginning of the file. If i doesn’t make sense, more 
skips back to the first file. If more is not reading from a file, the 
bell rings and nothing else happens. 

:f Displays the current filename and line number. 

:q or ;Q 

Exits from more (same as q or Q). 

. Repeats the previous command. 

The commands take effect immediately. It is not necessary to enter a 
carriage return. Up to the time when the command character itself is 
given, the user may enter the line kill character to cancel the numeri- 
cal argument being formed. In addition, the user may enter the erase 
character to redisplay the More— (xx%)” message. 

The terminal is set to noecho mode by this program so that the output 
can be continuous. What you enter will not show on your terminal, 
except for the slash (/) and exclamation (!) commands. 

If the standard output is not a teletype, more acts just like cat, except 
that a header is printed before each file (if there is more than one). 

A sample usage of more in previewing wrojf output would be 

nrofif -ms +2 doc.n 1 more -s 



Files 



/etc/termcap Terminal data base 

/usr/lib/more.help Help file 

See Also 



csh(C), sh(C), environ(M) 

Credit 



This Utility was developed at the University of California at Berkeley 
and is used with permission. 
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Notes 



The vi and help options may not be available. 

Before displaying a file, more attempts to detect whether it is a non- 
printable binary file such as a directory or executable binary image. If 
more concludes that a file is unprintable, it refuses to print it. How- 
ever, more cannot detect all possible kinds of non-printable files. 
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mv 

moves or renames files and directories 

Syntax 



mv [ -f ] filel file2 

mv [ -f ] directory 1 directory 2 

mv [ -f ] file ... directory 

Description 



mv moves (changes the name of) file! to file2 (or directory 1 to direc- 
tory!). 

If file! already exists, it is removed before filel is moved. If file! has 
a mode which forbids writing, mv prints the mode (see chmod{S)) and 
reads the standard input to obtain a line. If the line begins with y, the 
move takes place; if not, mv exits. 

In the third form, one or more files are moved to the directory with 
their original filenames. 

No questions are asked when the -f option is given. 
mv refuses to move a file onto itself. 

mv can only rename directories, not physically move them. 
mv<i/r(ADM) should be used to move directories within a filesystem. 

See Also 



cp(C), chmod(S), copy(C) 

Notes 



If filel and file! lie on different file systems, mv must copy the file 
and delete the original. In this case the owner name becomes that of 
the copying process and any linking relationship with other files is 
lost. 
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Standards Conformance 



mv is conformant with: 

AT&TSVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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newform 

changes the format of a text file 

Syntax 

newform [-s] [-itabspec] [-otabspec] [-bn] [-en] [-pn] [-an] [-f] 
[-cchar] [-In] [file ... ] 

Description 



newform reads lines from the named files, or the standard input if no 
input file is named, and reproduces the lines on the standard output. 
Lines are reformatted in accordance with command line options in 
effect. 

Except for -s, command line options may appear in any order, may be 
repeated, and may be intermingled with files . However, note that 
command line options are processed in the order typed. This means 
that option sequences like “-el 5 -160” will yield results different 
from “-160 -el5”. Options are applied to all files on the command 
line. 

•itabspec Input tab specification: expands tabs to spaces, according 
to the tab specifications given. Tabspec recognizes all tab 
specification forms described below. In addition, tabspec 
may be --, in which newform assumes that the tab specifi- 
cation is to be found in the first line read from the stan- 
dard input. If no tabspec is given, tabspec defaults to -8. 
A tabspec of -0 expects no tabs; if any are found, they are 
treated as -1. 

•otabspec Output tab specification: replaces spaces by tabs, accord- 
ing to the tab specifications given. The tab specifications 
are the same as for -itabspec. If no tabspec is given, 
tabspec defaults to -8. A tabspec of -0 means that no 
spaces will be converted to tabs on output. 

-In Sets the effective line length to n characters. If n is not 

typed, -I defaults to 72. The default line length without 
the -1 option is 80 characters. Note that tabs and back- 
spaces are considered to be one character (use -i to 
expand tabs to spaces). 

Note that the -1 option used alone does not produce the 
expected output unless accompanied by other line- 
altering options, such as -e. 
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-bn Truncates n characters from the beginning of the line 

when the line length is greater than the effective line 
length (see -1«). The default is to truncate the number of 
characters necessary to obtain the effective line length. 
The default value is used when -b with no n is used. This 
option can be used to delete the sequence numbers from a 
COBOL program as follows: 

newform -11 -hi file-name 

The option -11 must be used to set the effective line length 
shorter than any existing line in the file so that the -b 
option is activated. 

-en Truncates n characters from the end of the line. 

-Qk Changes the prefix/append character to k. Default charac- 

ter for /: is a space (see options -p and -c). 

-p« Prefixes n characters (see -ck) to the beginning of a line 

when the line length is less than the effective line length. 
The default is to prefix the number of characters neces- 
sary to obtain the effective line length. 

-a« Appends n characters to the end of a line. The default is 

to append the number of characters necessary to get the 
effective line length. 

-f Writes the tab specification format line on the standard 

output before any other lines are output. The tab specifi- 
cation format line which is printed will correspond to the 
format specified in the last -o option. If no -o option is 
specified, the line which is printed will contain the default 
specification of -8. 

■s Shears off leading characters on each line up to the first 

tab and places up to 8 of the sheared characters at the end 
of the line. If more than 8 characters (not counting the 
first tab) are sheared, the eighth character is replaced by a 
* and any characters to the right of it are discarded. The 
first tab is always discarded. 

An error message and program exit will occur if this 
option is used on a file without a tab on each line. The 
characters sheared off are saved internally until all other 
options specified are applied to that line. The characters 
are then added at the end of the processed line. 
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Tabs 

Four types of tab specification are accepted for tabspec: “canned,” 
repetitive, arbitrary, and file. The lowest column number is 1. For 
tabs, column 1 always refers to the leftmost column on a terminal, 
even one whose column markers begin at 0, e.g. the DASI 300, DASl 
300S, and DASI 450. 

The “canned” tabs are given as -code where code (and its meaning) is 
from the following list: 

-a 1,10,16,36,72 

Assembler, IBM S/370, first format 

-a2 1,10,16,40,72 

Assembler, IBM S/370, second format 

-c 1,8,12,16,20,55 

COBOL, normal format 

-c2 1,6,10,14,49 

COBOL compact format (columns 1-6 omitted). Using 
this code, the first typed character corresponds to card 
column 7, one space gets you to column 8, and a tab 
reaches column 12. Files using this tab setup should 
include a format specification as follows: 

<:t-c2 m6 s66 d:> 

-c3 1,6,10,14,18,22,26,30,34,38,42,46,50,54,58,62,67 

COBOL compact format (columns 1-6 omitted), with 
more tabs than COBOL -c2. This is the recommended 
format for COBOL. The appropriate format specification 
is: 

<:t-c3 m6 s66 d:> 

-f 1,7,11,15,19,23 

FORTRAN 

-p 1,5,9,13,17,21,25,29,33,37,41,45,53,57,61 

PL/I 

-s 1,10,55 

SNOBOL 

-u 1,12,20,44 

UNIVAC 1100 Assembler 

In addition to these “canned’ ’ formats, three other types exist: 

-« A repetitive specification requests tabs at columns 1+n, 

1+2*71, etc. Note that such a setting leaves a left margin of 

71 columns on TermiNet terminals only. Of particular 
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importance is the value -8: this represents the Altos UNIX 
System V system “standard” tab setting, and is the most 
likely tab setting to found at a terminal. It is required for 
use with nr off -h option for high-speed output. Another 
special case is the value -0, implying no tabs at all. 

«7,n2,... The arbitrary format permits the user to type any chosen 
set of number, separated by commas, in ascending order. 
Up to 40 numbers are allowed. If any number (except the 
first one) is preceded by a plus sign, it is taken as an incre- 
ment to be added to the previous value. Thus, the tab lists 
1,10,20,30 and 1,10,+10,+10 are considered identical. 

- -file 

If the name of a file is given, newform reads the first line 
of the file, searching for a format specification. If it finds 
one there, it sets the tab stops according to it, otherwise it 
sets them as -8. This type of specification may be used to 
make sure that a tabbed file is printed with correct tab set- 
tings. 

Any of the following may be used also; if a given flag occurs more 

than once, the last value given takes eflect: 

’Ttype 

newform usually needs to know the type of terminal in 
order to set tabs and always needs to know the type to set 
margins, type is a name listed in (CT). If no -T flag 
is supplied, newform searches for the $TERM value in 
the environment (see environ(M)). If no type can be 
found, newform tries a sequence that will work for many 
terminals. 

+mn The margin argument may be used for some terminals. It 

causes all tabs to be moved over n columns by making 
column n+l the left margin. If +m is given without a 
value of «, the value assumed is 10. For a TermiNet, the 
first value in the tab list should be 1, or the margin will 
move even further to the right. The normal (leftmost) 
margin on most terminals is obtained by +m0. The mar- 
gin for most terminals is reset only when the +m flag is 
given explicitly. 

Example 



In the following example, newform converts a file named text with 
leading digits, one or more tabs, and text on each line to a file begin- 
ning with the text and the leading digits placed at the end of each line 
in column 73 (-s option). All tabs after the first one are expanded to 
spaces (-1 option). To reach the line length of 72 characters (-1 option), 
spaces are appended to each line up to column 72 (-a option) or lines 
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are truncated at column 72 (-e option). To reformat the sample file 
text in this manner, enter: 

newform -s -i -1 -a -e text 



Exit Codes 



0 - normal execution 

1 - for any eiror 

See Also 




csplit{C) 

Diagnostics 




All diagnostics are fatal. 


usage: ... 


newform was called with a bad option. 


not -s format 


There was no tab on one line. 


can't open file 


Self-explanatory. 


internal line too long 


A line exceeds 512 characters after being 
expanded in the internal work buffer. 


tabspec in error 


A tab specification is incorrectly format- 
ted, or specified tab stops are not ascend- 
ing. 


tabspec indirection illegal A tabspec read from a file (or standard 

input) may not contain a tabspec referenc- 
ing another file (or standard input). 

Notes 



newform normally only keeps track of physical characters; however, 
for the -i and -o options, newform will keep track of backspaces in 
order to line up tabs in the appropriate logical columns. 

newform will not prompt the user if a tabspec is to be read from the 
standard input (by use of -i,- or -o-). 

If the -f option is used, and the last -o option specified was “-o--” , 
and was preceded by either “-o-” or a “-i— ” , the tab specification 
format line will be incorrect. 
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newgrp 

logs user into a new group 

Syntax 

newgrp [-] GROUP 

Description 



newgrp changes the group identification of its caller. The same per- 
son remains logged in, and the current directory is unchanged, but cal- 
culations of access permissions to files are performed with respect to 
the new group ID. 

newgrp without an argument changes the group identification to the 
group in the password file. This changes the caller’s group identifica- 
tion back to the original group. 

If the first argument to newgrp is a hyphen (-), the user will actually 
be logged in again as a member of the new group, GROUP, (that is, 
newgrp - GROUP) 

If the first argument to newgrp is a “ - but GROUP is not specified, 
the user will be logged in again as a member of the caller’s original 
group identification according to the password file. 

Files 



/etc/group 

/etc/passwd 

See Also 



login(M), group(F) 

Notes 



The newgrp command executes, but does not fork, a new shell. If your 
login shell is a C shell and you invoke newgrp , you will have to press 
CTRL-D when you wish to log out. Typing the csh (C) logout com- 
mand will result in an error message. Note also that the newgrp com- 
mand causes the csh history list to start again at 1. 
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Standards Conformance 



newgrp is conformant with: 

AT&TSVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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news 

print news items 

Syntax 

news [ -a ] [ -n ] [ -s ] [ items ] 

Description 



news is used to keep the user informed of current events. By conven- 
tion, these events are described by files in the directory /usr/news. 

When invoked without arguments, news prints the contents of all 
current files in /usr/news, most recent first, with each preceded by an 
appropriate header, news stores the ‘‘currency” time as the modifica- 
tion date of a file named .news_time in the user’s home directory (the 
identity of this directory is determined by the environment variable 
$HOME); only files more recent than this currency time are con- 
sidered “current.” 

The -a option causes news to print all items, regardless of currency. 
In this case, the stored time is not changed. 

The -n option causes news to report the names of the current items 
without printing their contents, and without changing the stored time. 

The -s option causes news to report how many current items exist, 
without printing their names or contents, and without changing the 
stored time. 

All other arguments are assumed to be specific news items that are to 
be printed. 

If the INTERRUPT key is struck during the printing of a news item, 
printing stops and the next item is started. Another INTERRUPT 
within one second of the first causes the program to terminate. 

Files 



/usr/news/* 

$HOME/.news_time 
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See Also 



NEWS (C) 



profile(M), environ(M) 

Standards Conformance 



news is conformant with: 

AT&TSVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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nice 

runs a command at a different scheduling priority 

Syntax 

nice [ -increment ] command [ arguments ] 

Description 



The nice command is used to execute a command at a different sched- 
uling priority than usual. Each process has a “nice value” which is 
used to calculate its priority. Nice values range from 0 to 39, with 
higher nice values resulting in lower priorities. By default, commands 
have a nice value of 20. nice executes command with a nice value 
equal to 20 plus increment . If no increment is given, an increment of 
10 is assumed. 

The super-user may run commands with priority higher than normal 
by using a double negative increment. For example, an argument of 
--10 would decrement the default to produce a nice value of 10, which 
is a higher scheduling priority than the default of 20. 

See Also 



nohup(C), csh(C), nice(S) 

Diagnostics 



nice returns the exit status of command. 

Notes 



If the default nice value plus increment is larger than 39, a nice value 
of 39 will be used. If a nice value less than zero is requested, zero will 
be used. 

Note also that this description of nice applies only to programs run 
under the Bourne Shell. The C-Shell has its own nice command, 
which is documented in csh(C). 

Standards Conformance 



nice is conformant with: 
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AT&TSVID Issue 2, Select Code 307-127. 
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nl 

adds line numbers to a file 

Syntax 



nl [-htype] [-btype] [-ftype] [-vstart#] [-iincr] [-p] [-Inum] [-ssep] 
[-wwidth] [-nformat] file 

Description 



nl reads lines from the named file, or the standard input if no file is 
named, and reproduces the lines on the standard output. Lines are 
numbered on the left in accordance with the command options in 
effect. 

nl views the text it reads in terms of logical pages. Line numbering is 
reset at the start of each logical page. A logical page consists of a 
header, a body, and a footer section. Empty sections are valid. Dif- 
ferent line numbering options are independently available for header, 
body, and footer (e.g. no numbering of header and footer lines while 
numbering blank lines only in the body). 

The start of logical page sections is signaled by input lines containing 
nothing but the following character(s): 

Page Section Line Contents 

Header \ :\ :\ : 

Body \:\: 

Footer \ : 

Unless signaled otherwise, nl assumes the text being read is in a sin- 
gle logical page body. 

Command options may appear in any order and may be intermingled 
with an optional filename. Only one file may be named. The options 
are: 

’htype Specifies which logical page body lines are to be num- 
bered. Recognized types and their meaning are: a, num- 
ber all lines; t, number lines with printable text only; n, 
no line numbering; pstring, number only lines that con- 
tain the regular expression specified in string. Default 
type for logical page body is t (text lines numbered). 
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-htype Same as -btype except for header. Default type for logi- 
cal page header is n (no lines numbered). 

4type Same as -btype except for footer. Default for logical page 
footer is n (no lines numbered). 

-p Does not restart numbering at logical page delimiters. 

•\startU Start# is the initial value used to number logical page 
lines. Default is 1. 

Aincr Incr is the increment value used to number logical page 
lines. Default is 1. 

-ssep Sep is the character(s) used in separating the line number 
and the corresponding text line. Default sep is a tab. 

-yfwidth Width is the number of characters to be used for the line 
number. Default width is 6. 

-nformat Format is the line numbering format. Recognized values 
are: In, left justified, leading zeroes suppressed; rn, right 
justified, leading zeroes suppressed; rz, right justified, 
leading zeroes kept. DtfdixAi format is rn (right justified). 

•Inum Num is the number of blank lines to be considered as one. 

For example, -12 results in only the second adjacent blank 
being numbered (if the appropriate -ha, -ba, and/or -fa 
option is set). Default is 1. 

See Also 

pr(C) 

Standards Conformance 

nl is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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nohup 

runs a command immune to hangups and quits 

Syntax 



nohup command [ arguments ] 

Description 



nohup executes command with hangups and quits ignored. If output is 
not redirected by the user, it will be sent to nohup.out. If the user 
does not have write permission in the current directory, output is 
redirected to $HOME/nohup.out. 

See Also 



nice(C), signal(S) 

Standards Conformance 



nohup is conformant with: 

AT&TSVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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od 

displays files in octal format 

Syntax 



od [-bcdox] [ file ] [ [ + ]offset[ . ][ b ] ] 

Description 



od displays /i/e in one or more formats as selected by the first argu- 
ment. If the first argument is missing, -o is default. The meanings of 
the format options are: 

-b Interprets bytes in octal. 

-c Interprets bytes in ASCII. Certain nongraphic characters 
appear as C escapes: null=\0, backspace=\b, form feed=\f, 
newline=\n, retum=\r, tab=\t; others appear as 3-digit octal 
numbers. 

-d Interprets words in decimal. 

-o Interprets words in octal. 

-X Interprets words in hex. 

The file argument specifies which file is to be displayed. If no file 
argument is specified, the standard input is used. 

The offset argument specifies the offset in the file where displaying is 
to start. This argument is normally interpreted as octal bytes. If . is 
appended, the offset is interpreted in decimal. If b is appended, the 
offset is interpreted in blocks. If the file argument is omitted, the 
offset argument must be preceded by +. 

The display continues until end-of-file. 

See Also 



hd(C), adb(CP) 

Standards Conformance 



od is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 
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and The X/Open Portability Guide II of January 1987. 
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Otar 

original tape archive command 

Syntax 



Otar 

Syntax 



tar [crtux] [bBefFilhklmnopsvVw 0,...,7] [arguments] file ... 

Description 



The Otar command saves and restores files on magnetic tape or floppy 
disk. Altos UNIX System V contains otar to provide compatibility 
with original tar archives made on the earlier Altos System V operat- 
ing system. Refer to the “Notes” section below for other guidelines 
on using tar to read archives produced with otar (or with tar on Altos 
System V). 

In addition to providing compatability with Altos System V’s original 
tar command, otar offers these other features: 

• Creates/copies directories even if they are empty, whereas tar 
does not. 

• Copies device nodes and pipes, whereas tar does not. 

• Retains file and directory permissions as originally copied 
(unless when used with the o option). 

• Incremental backups (with the I option). 

• Multivolume archiving. 

The actions produced by otar are controlled by a key argument, which 
contains at least one function letter followed by one or more function 
modifiers. Other arguments to the command are file or directory 
names specifying which files are to be dumped or restored. In all 
cases, a directory name refers to the files and (recursively) subdirec- 
tories of that directory. 

Tar permits a file to extend across media boundaries. 
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Specify the function portion of the key by one of the following letters: 

c Creates a new tape; writing begins at the beginning of the tape 
instead of after the last file. When you use this command, all pre- 
vious data is erased. 

r Writes the named files at the end of the tape (only for seekable de- 
vices). 

t Lists the named file each time it occurs on the tape. If no file argu- 
ment is given, all of the names on the tape are listed. 

u Adds the named file to the tape if it is not already there or if it has 
been modified since last put on the tape. This option can be slow 
(only for seekable devices). 

X Extracts the named file from the tape. If the named file matches a 
directory whose contents have been written on the tape, this direc- 
tory is (recursively) extracted. The owner and mode are restored 
(if possible). If no file argument is given, the entire content of the 
tape or floppy is extracted. If multiple entries specifying the same 
file are on the tape, the last version will overwrite all preceding 
versions. 

In addition to the key argument function, you can use the following 

modifiers. Arguments to the modifiers are given in the same order as 

the modifiers themselves. 

b Causes otar to use the next argument as the blocking factor for 
tape records. The default blocking size is 18 for floppies, 126 for 
cartridge tapes, 20 for other tapes, and 1 for all other devices. Use 
the same blocking factor on the x (extract) as used on the c (create) 
option. (The rar default for Altos System V on 386 computers was 
also 18, and the maximum was 1024. The blocking defaults for the 
Altos UNIX System V tar are set in /etc/default/tar.) 

This option should be used to set different blocking factors only on 
raw magnetic tape archives (see f below). Use the default block- 
ing factors for all other devices. 

Don’t use the b option with archives that are going to be updated. 
If the archive is on a disk file, the b option should not be used at 
all, as updating an archive stored in this manner can destroy it. 

B Archives all files modified after the modification date and time of 
the file you specify (instead of /etc/bkupdate). 
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Can only be used with the I option. Also otar sets the modification 
time of the given file after the backup is complete. The B option 
sets the modification time in the user-specified file. For example: 

Otar cvfbBI /dev/rctO 1024 /etc/time file ./* 

The user- specified file is set to zero length when its modification 
date is set. 

e Prevents files from being split across volumes (tapes or disks). If 
there is not enough room on the present volume for a given file, 
Otar prompts for a new volume. This is only valid when you also 
specify the k option. 

f Causes otar to use the next argument as the name of the archive 
instead of /dev/tar. If the name of the file is otar writes to 

standard output or reads from standard input, whichever is appro- 
priate. Thus, you can use tar to move hierarchies with the com- 
mand: 

cd fromdir; otar cf - . I (cd todir; otar xf -) 

You must use this option with magnetic tape and add-on hard 
disks. The default is to floppy disk. 

F Causes otar to use the next argument as the name of a file from 
which succeeding arguments are taken. A dash (-) signifies that 
arguments are taken from the standard input. 

h Archives the contents of the symbolically-linked named files, otar 
cv will only archive linkage information; tar chv will archive the 
contents. 

i date time 

Archives all files modified after date and time. The format for date 
and time is: 

MMIDDIYYMH:M1N:SEC 

Files modified before date and time will be skipped. Any trailing 
portion may be omitted. DD, HH, and MIN default to 0; YY 
defaults to the current year. For example: 

otar cvif 12/22/86,04:00:00 /dev/rctO files 

I Archives all files modified after the date and time as defined by the 
modification time of the file /etc/bkupdate. Also, sets the 
modification time of /etc/bkupdate after the backup is complete. 
To use a different file, see the B option. 



March 15, 1991 



OTAR-3 




OTAR (C) 



OTAR (C) 



k Causes otar to use the next argument as the size of an archive vol- 
ume in kilobytes. The minimum value allowed is 250. This value 
must be a multiple of the blocking factor (9K by default). For tape, 
you can specify the block size using the b option. Very large files 
are split into “extents” across volumes. When restoring from a 
multivolume archive, otar only prompts for a new volume if a split 
file has been partially restored. 

1 Tells otar to notify you if the link count of a dumped file doesn’t 
match the actual number of dumped links to that file. If this option 
is not specified, no error messages are printed. 

m Tells otar not to restore the modification time; the time of extrac- 
tion then becomes the modification time. 

n Indicates the archive device is not a magnetic tape. The k option 
implies this. Because it can seek over files it wishes to skip, otar 
can quickly list and extract the contents of an archive. Sizes are 
printed in kilobytes instead of tape blocks. 

o Causes extracted files to take on the user/group identifier of the 
user running the program, rather than those on the tape. 

p Indicates that files are extracted using their original permissions. 
It is possible that a regular user may be unable to extract files 
because of the permission associated with the files or directories 
being extracted. 

s file 

Runs the Ibinisum algorithm on the archive and writes the resulting 
checksum in file. 

V Displays the name of each file it treats preceded by the function 
letter. With the t function, v gives more information about the tape 
entries than just the name and path. 

V Verifies the named file on the tape, otar will compare the tape file 
to the disk file and report any file change or comparison errors. If 
no file argument is given, the entire contents of the tape or floppy 
is verified, otar will exit with an exit code of 9 if there are any 
verify errors. 

w Causes otar to display the action to be taken and file name, then 
wait for user confirmation. If you type y, the action is performed. 
Any other input causes the file to be skipped. 

0,...,7 

Selects the drive on which the archive is mounted. This option 
should only be selected if you have linked the appropriate /dev/mt 
to the desired device. 
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/dev/tar Default input/output device 
/tmp/tar* 

Examples 



This command copies the directory /usr/john to floppy disk(s): 

Otar cv /usr/john 

This command copies the files on the floppy disk to the directory 
/usr/john. The cd command is used first to make sure you are in the 
correct directory: 

cd /usr/john 
Otar XV 

This command displays the contents of the floppy disk you have in the 
drive: 

Otar tv 

This command pipes the otar tv command through the Ipr command. 
This causes the contents of the floppy disk to be printed out on your 
serial printer: 

Otar tv I Ipr 

This command copies files from a floppy disk device named 
/dev/fdl96dsl5, a 5% inch floppy drive configured as the second 
floppy drive (fdl). (Other arguments are files, the names of files to 
archive, and 1152, the capacity of the disk in kilobytes). Arguments 
to key letters are given in the same order as the key letters themselves, 
thus the fk key letters have corresponding arguments /dev/fdl96dsl5 
and 1152. If a file is a directory, the contents of the directory are 
recursively archived: 

Otar cvfk /dev/fdl96dsl5 1152 files 

This command extracts all the files with the exact same pathnames 
used when the archive was created: 

Otar xvf /dev/fd096dsl5 

This command copies the directory /usr/john to cartridge tape(s): 

Otar cvfb /dev/rctO 126 /usr/john 
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Notes 



If you use tar to read an archive created by otar, you may see error 
messages concerning directories, pipes, or device nodes. You should 
ignore these messages. Your tar operation will still work. Note, how- 
ever, that you should still use the same blocking factor to read a tape 
as was used to originally create the tape. 

Value Added 



Otar is an extension of AT&T System V provided by Altos UNIX Sys- 
tem V. 
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pack, peat, unpack 

compresses and expands files 

Syntax 

pack [ - ] name . . . 
peat name . . . 
unpack name . . . 

Description 



pack attempts to store the specified files in a compressed form. Wher- 
ever possible, each input file name is replaced by a packed file 
name,z with the same access modes, access and modified dates, and 
the owner of name. If pack is successful, name will be removed. 
Packed files can be restored to their original form using unpack or 
peat. 

pack uses Huffman (minimum redundancy) codes on a byte-by-byte 
basis. If the - argument is used, an internal flag is set that causes pack 
to display information about the file compression. Additional occur- 
rences of - in place of name will cause the internal flag to be set and 
reset. 

The amount of compression obtained depends on the size of the input 
file and the character frequency distribution. Because a decoding tree 
forms the first part of each ,z file, it is usually not worthwhile to pack 
files smaller than three blocks, unless the character frequency distri- 
bution is very scattered, which may occur with printer plots or pic- 
tures. 

Typically, text files are reduced to 60-75% of their original size. Load 
modules, which use a larger character set and have a more uniform 
distribution of characters, show little compression, the packed ver- 
sions being about 90% of the original size. 

pack returns a value that is the number of files that it failed to 
compress. 

No packing will occur if: 

- The file appears to be already packed 
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- The filename has more than 12 characters 

- The file has links 

- The file is a directory 

- The file cannot be opened 

- No disk storage blocks will be saved by packing 

- A file called name.z already exists 

- The .z file cannot be created 

- An I/O error occurred during processing 

The last segment of the filename must contain no more than 12 char- 
acters to allow space for the appended .z extension. Directories can- 
not be compressed. 

Peat does for packed files what cat{C) does for ordinary files. The 
specified files are unpacked and written to the standard output. Thus 
to view a packed file named name.z use: 

peat name.z 

or just: 

peat name 

To make an unpacked copy, say nnn, of a packed file named name.z 
without destroying name.z, enter the command: 

peat name >nnn 

Peat returns the number of files it was unable to unpack. Failure may 
occur if: 

- The filename (exclusive of the .z) has more than 12 characters 

- The file cannot be opened 

- The file does not appear to be the output of pack 

unpack expands files created by pack. For each file name specified in 
the command, a search is made for a file called name.z (or just name, 
if name ends in .z). If this file appears to be a packed file, it is 
replaced by its expanded version. The new file has the .z suffix 
stripped from its name, and has the same access modes, access and 
modification dates, and owner as those of the packed file. 
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unpack returns a value that is the number of files it was unable to 
unpack. Failure may occur for the same reasons that it may in peat, as 
well as in a file where the “unpacked” name already exists, or if the 
unpacked file cannot be created. 

Standards Conformance 



pack, peat and unpack are conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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passwd 

change login, modem (dialup shell), filesystem, or 
group password 

Syntax 



passwd [ -mgF ] [ -diuf ] [ -n minimum ] [ -x expiration ] [ -r retries ] 
[ name ] 

passwd -s [ -a ] [ name ] 

Description 



The passwd command is used by ordinary users to: 

• Change or delete their own login password. 

• List some of the attributes that apply to their account. 

In addition, system administrators can use the passwd command to: 

• Change or delete any user’s login password. 

• Change or delete modem (dialup shell), filesystem mount, and 
group passwords. 

• Lock or unlock any user’s account. 

• Invalidate (lock) dialup shell, filesystem, and group passwords. 

• List some of the attributes of all users, or any single user. 

• Change some of the attributes of any user. 

However, it is recommended that system administrators use the 
sysadmsh( ADM) Accounts selection to administrate passwords. A 
user is considered to be a system administrator if they are logged in as 
someone who has the auth subsystem authorization. 



Choosing a good password. 

Your login password is one of the most important defenses against 
security breaches. If a malicious person cannot log into a system, it is 
much harder for that person to steal or tamper with your data. Hence, 
by choosing a hard-to-guess password (either of your own invention or 
one suggested by the system), regularly changing it, and keeping it 
secret, you can foil many attacks on your system. 
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In general, a password should : 

• Consist of a mixture of upper- and lower-case letters, digits (0 - 9), 
and other non-letters (such as @, *, -, /, space, tab, and control 
characters). 

• Be changed frequently (at least once every six months to a year, 
and more often as necessary). 

• Be different on different machines. 

• Be easy to remember, so you don’t have to write it down. 

• Be kept secret and known only by you. 

Passwords should not: 

• Be the name of a person, place, or thing; nor should a password be 
the same as any user’s login name, any machine’s name, or the 
name of any group. 

• Be a correctly spelt word, street or telephone number, ZIP or postal 
code; nor should a password be a birthday or anniversary of you or 
anyone you know. 

• Be written down (anywhere! - not on paper or in a file); nor should 
passwords be stored in the function keys of a terminal or memory 
of an intelligent modem. 

• Be told to any other person (not even for use in an “emergency”); 
nor should a password be kept if you suspect someone else knows 
it. 

Spelling a word backwards or appending a digit to a word do not turn 
a poor password choice into a “good” password. However, taking 
two or three unrelated words and combining them with some non- 
letters is a reasonable way of choosing an easy-to-remember but 
hard-to-crack password. On Altos UNIX System V, passwords can be 
up to 80 characters long, so nonsensical rhymes (for example) can also 
be used as passwords. 

User login passwords. 

When passwd is used to change or delete the password for user name^ 
the old password (if any) is prompted for. (The password is not dis- 
played as it is being entered.) System administrators are not prompted 
for the old password unless they are attempting to change their own 
password; the superuser is never prompted for the old password. The 
passwd command can only be used to change or delete the password 
for user name by system administrators and the user authorized to 
change user name's password. Normally, users are authorized to 
change their own password. 
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Depending on how the system administrator has configured the 
account, the user may or may not be able to choose their own pass- 
word, or may have a password chosen for them. If they can neither 
choose their own password nor have passwords generated for them, 
the password cannot be changed. If the user is able to do both, passwd 
asks which should be done. 

A password is considered valid until it has expired. Passwords expire 
if they are not changed or deleted before the expiration time has 
passed. Once expired, the user is required to change (not delete) their 
password the next time they log in. If a user fails to do so before the 
password’s lifetime has passed, the password is considered dead and 
the user’s account is locked. 

Once locked, the user may not log in, may not be .yw(C)’ed to, and no 
at(C), batch (C), or cron(C) jobs for that user may run. Only a system 
administrator can unlock a user with a dead password; a new password 
must be assigned. 

To discourage re-use of the same password, the system administrator 
may set a minimum change time . After changing or deleting a pass- 
word, the password may not be changed again (even by a system 
administrator) until at least that much time has elapsed. 

Passwords may be deleted (or changed to be empty) only if the user is 
authorized to not have a password. Users without passwords are not 
recommended. (An empty password is prompted for when logging in, 
but a deleted password is not prompted for at login.) 

If a password is being changed and the user has elected (or is forced) 
to choose a system- generated password, each suggested password is 
printed along with a hyphenated spelling that suggests how the pass- 
word could be pronounced. To accept a suggested password, enter the 
password; if entered correctly, passwd will prompt for the suggested 
password to be entered again as confirmation. To reject a suggestion, 
just enter RETURN ; to abort the change altogether, either enter 
‘‘quit” or interrupt passwd. 

If a password is being changed and the user has elected (or is forced) 
to assign a password of their own choosing, the new password is 
prompted for twice. It is checked for being “obvious” after the first 
prompt, and if deemed to be acceptable is prompted for again. If the 
proposed password is successfully entered a second time, it becomes 
the new password for user name . 

Both system- generated and self-chosen passwords are checked for 
being easy-to-guess. See the section on “Checking for obvious pass- 
words” (below) for a description of the checks. 
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When dealing with a user’s login password, the following options are 

recognized: 

-d Delete the password. A password may be deleted only if the user 
is authorized to not have a password. System administrators must 
always specify name ; otherwise, the name of the user who logged 
in is used. 

-f Force user name to change their password the next time they log 
in. This option may be specified only by system administrators, 
and only when the user’s password is not being changed or deleted; 
name must be explicitly given. 

-1 Lock user name out of the system by applying an administrative 
lock; only system administrators may do this and they must specify 
name. 

-u Remove any administrative lock applied to user name ; only system 
administrators may do this and they must specify name . 

-n minimum 

Set the amount of time which must elapse between password 
changes for user name to minimum days. Only system administra- 
tors may do this and they must specify name . 

-X expiration 

Set the amount of time which may elapse before the password of 
user name expires to expiration days. Only system administrators 
may do this and they must specify name. Once a password has 
expired, the user must change it the next time they log in. 

-r retries 

Up to retries attempts may be made to choose a new password for 
user name . 

-s Report the password attributes of user name (or, if the -a option is 
given, of all users). The format of the report is: 

name status mmiddlyy minimum expiration 

where status is PS if the user has a password, LK is the user is 
administratively locked, or NP when the user does not have a pass- 
word. The date of the last successful password change (or dele- 
tion) is shown as mmiddlyy. If neither name nor -a is specified, the 
name of the user who logged in is assumed. Only system adminis- 
trators can examine the attributes of users other than themselves. 
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If no -d, -f, -1, -u, or -s option is specified, the password for user name 
is changed as described above. If no name is given and no option 
which requires name is given, then the name of the user who logged in 
is used. Only the -a option may be specified with the -s option. 



Modem (dialup shell) passwords. 

When a user whose login shell is listed in /etc/d passwd with a 
(encrypted) password logs in on a terminal line listed in /etc/dialups, 
the password in /etc/d_passwd must be supplied before the login 
succeeds. The -m option to password allows system administrators to 
change, delete, or invalidate (lock) the passwords for login shell 
name: 

-d Delete the password. 

-1 Invalidate (“lock”) the password by arranging so that no matter 
what the user enters, it will not be a valid password. Doing so 
causes the old password to be lost. 

-r retries 

Up to retries attempts may be made to choose a new password. 

The name must always be specified. If name begins with a slash (“/”) 
the entire shell pathname must match. Otherwise the password for 
every shell whose basename is name is changed. 

If neither the -d nor -1 option is specified, the password is changed. 
The new password is prompted for twice, and must pass checks similar 
to those for login passwords (see below). 



Filesystem mount passwords. 

A password may be required when mounting a filesystem; see mnt(C). 
The -F option to passwd allows system administrators to change, 
delete, or invalidate (lock) the password for filesystem name. The 
options are the same as for modem passwords (see above). 



Group passwords. 

A password may be required when a user changes their current work- 
ing group; see newgrpiC). The -g option to passwd allows system 
administrators to change, delete, or invalidate (lock) the password for 
group name . The options are the same as for modem passwords (see 
above). 
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Checking for obvious passwords. 

To discourage poor password choices, various checks are applied to 
reject unacceptable passwords. The checks which are applied depend 
on the type of password being checked and the system’s configuration. 
Most of the checks for being easy-to-guess are configurable; see 
goodpw{ADM). 

The check procedure is as follows (a password is restricted if, accord- 
ing to sysadmsh Accounts, it is to be “checked for obviousness”): 

la. 

User login passwords only: The new password must not be the 
same as the old password. The password must not be empty (or be 
deleted) unless the user is not required to have a password. 



lb. 

All other passwords: The new and old password may be the same. 
Empty passwords are treated as deleted passwords and are always 
acceptable. 

2. All (non-empty) passwords: If the password is not empty, it must 
be at least PASSLENGTH characters long (see below). 

3. Ail (non-empty) passwords: If the goodpw utility can be run, it is 

used to perform all further checks. If the file 

CHECKDIR! type Strength exists (and can be read by goodpw) that 
file is used to modify the default settings in /etc/default/goodpw. 
The CHECKDIR is specified by CHECKDIR in 

/etc/default/passwd and type is the kind of password being 
checked (user, modem, group, or filsys). The strength is the 
degree of checking to be done: secure if the user is restricted (or, 
for all other password types, if the system default is restricted); 
otherwise weak. 

4. When goodpw cannot be run (all passwords): If the password is 
not empty, it must contain at least one character which is not a 
lower case letter (but must not consist solely of digits). 

5. When goodpw cannot be run (user login passwords only): Finally, 
for user login passwords which are restricted, the password must 
not be a palindrome, any user’s login name, the name of any group, 
or a correctly spelt English word (American spelling); see 
accept _pw(S). 

System-generated passwords are not checked unless the user is re- 
stricted (see above), in which case the generated password must pass 
the checks in step 5 before it is suggested to the user. Generated pass- 
words are never checked by goodpw. The minimum value for 
PASSLENGTH, and the minimum length of a generated password, 
are computed based on the password’s lifetime, delay between login 
attempts, and other factors; see passlen(S). 
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Defaults. 

Several parameters may be specified in /etc/default/passwd. The 
various settings, and their default values are: 

PASSLENGTH=5 

The minimum length of a password. If outside the range 3 to 80 
(inclusive), then it is set to 5. The actual minimum length used by 
passwd is the maximum of this value and a value computed by tak- 
ing into consideration the lifetime of the password (and other fac- 
tors). 

RETRIES=4 

The maximum number of repeated attempts to change a password 
that has been rejected. If less than 2, then 2 is assumed. 

ONETRY=YES 

If set to YES, a rejected password is added to the stop-list passed 
to goodpw. This prevents simplistic modifications of a rejected 
password from being accepted on a later attempt. 

DESCRIBE=/usr/lib/goodpw/describe 

The contents of this file are shown once (before the new password 
is prompted for) and should describe the the difference between 
acceptable and unacceptable passwords. 

SUMMARY =/usr/lib/goodpw/summary 

The contents of this file are shown each time a password is 
rejected, and should be a (short) reminder of what are and are not 
acceptable passwords. 

CHECKDIR=/usr/lib/goodpw/checks 

A hierarchy of additional checks goodpw should perform, based on 
password type and restrictions (see above). 

GOODPW=/usr/bin/goodpw 

An independent program that applies various checks in an attempt 
to determine whether or not a password is easily guessed. 

The values for the default settings may be changed to reflect the 
system’s security concerns. 

If /etc/default/passwd does not exist or is not readable, the above 
default values are used. 

If the DESCRIBE or SUMMARY file defined in /etc/default/passwd 
does not exist or cannot be read, short (and vague) descriptions or 
summaries are issued instead. In addition, if the user who logged in is 
a system administrator, an error message describing the problem is 
printed. 
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If the GOODPW program does not exist or is not executable, simpler 
checks are done (see above). In addition, if the user who logged in is a 
system administrator, an error message describing the problem is 
printed. 

Files 



/etc/passwd 

List of user accounts. 

/tcb/files/ mih! initial Inarm 

Protected Password database entry for user name (where the first 
character in name is initial ). 

/etc/group 

List of groups. 

/etc/djpasswd 

List of dialup shells and passwords (one per line); 

shell lencrypted-password preserved 
where shell is the pathname of a login shell as used in /etc/passwd. 

/etc/auth/system/files 
File Control database. 

/etc/auth/system/default 

System Defaults database; contains default parameters. 

/etc/default/passwd 

Configurable settings (see above). 

See Also 



accept_pw(S), authcap(F), authsh(ADM), default(F), goodpw(ADM), 
group(F), login(M), mnt(C), newgrp(C), passlen(S), passwd(F) 
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Notes 



Group passwords should be avoided; see newgrp(C). Not all systems 
support group passwords. 

Not all systems support filesystem mount passwords. 

Not all systems support modem (dialup shell) passwords. 

The -r option is mostly useful during installation to force the newly- 
installed superuser to have a password. 
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paste 

merges lines of files 

Syntax 



paste filel file2 . . . 
paste -dlel file2 . . . 
paste -s [-dlist] filel file2 . . . 

Description 



In the first two forms, paste concatenates corresponding lines of the 
given input files filel , file2 , etc. It treats each file as a column or 
columns of a table and pastes them together horizontally (parallel 
merging). It is the counterpart of cat(C) which concatenates verti- 
cally, i.e., one file after the other. In the last form above, paste sub- 
sumes the function of an older command with the same name by com- 
bining subsequent lines of the input file (serial merging). In all cases, 
lines are glued together with the tab character, or with characters from 
an optionally specified list . Output is to the standard output, so it can 
be used as the start of a pipe, or as a filter, if - is used in place of a 
filename. 

The meanings of the options are: 

-d Without this option, the newline characters of each but the last file 
(or last line in case of the -s option) are replaced by a tab charac- 
ter. This option allows replacing the tab character by one or more 
alternate characters. (See below.) 



list 

One or more characters immediately following -d replace the 
default tab as the line concatenation character. The list is used cir- 
cularly, i. e. when exhausted, it is reused. In parallel merging (i. e. 
no -s option), the lines from the last file are always terminated with 
a newline character, not from the list. The list may contain the 
special escape sequences: \n (newline), \t (tab), W (backslash), and 
\0 (empty string, not a null character). Quoting may be necessary, 
if characters have special meaning to the shell (e.g. to get one 
backslash, use -d’WW ” ). 

-s Merges subsequent lines rather than one from each input file. Use 
tab for concatenation, unless a list is specified with -d option. 
Regardless of the list, the very last character of the file is forced to 
be a newline. 
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- May be used in place of any filename to read a line from the stan- 
dard input. (There is no prompting.) 



Examples 



Is I paste -d” " - 

Is I paste 

paste -s -d”\t\n" file 

See Also 


Lists directory in one column 
Lists directory in four columns 
Combines pairs of lines into lines 


cut(C), grep(C), pr(C) 

Diagnostics 




line too long 


Output lines are restricted to 51 1 characters. 


too many files 


Except for -s option, no more than 12 input 
files may be specified. 


Standards Conformance 



paste is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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pax 

portable archive exchange 

Syntax 



pax [-cimopuvy] [4 archive] [‘Sreplstr] [4 device] [pattern...] 

pax -r [-cimnopuvy] [4 archive] [sreplstr] [4 device] [pattern...] 

pax -w [-adimuvy] [-b blocking] [-f archive] [-s replstr] [-t device] 
[•\ format] [pathname...] 

pax -rw [-ilmopuvy] [-s replstr] [pathname...] directory 

Description 



pax reads and writes archive files which conform to the 
Archive/Interchange File Format specified in IEEE Std. 1003.1- 
1988. pax can also read, but not write, a number of other file formats 
in addition to those specified in the Archive/Interchange File For- 
mat description. Support for these traditional file formats, such as V7 
tar and System V binary cpio format archives, is provided for back- 
ward compatibility and to maximize portability. 

pax will also support traditional cpio and System V tar interfaces if 
invoked with the name “cpio” or “tar” respectively. See the cpio(C) 
or tar(C) manual pages for more details. 

Combinations of the -r and -w command line arguments specify 
whether pax will read, write or list the contents of the specified 
archive, or move the specified files to another directory. 

The command line arguments are: 

-w writes the files and directories specified by pathname operands 
to the standard output together with the pathname and status in- 
formation prescribed by the archive format used. A directory 
pathname operand refers to the files and (recursively) subdirec- 
tories of that directory. If no pathname operands are given, 
then the standard input is read to get a list of pathnames to 
copy, one pathname per line. In this case, only those path- 
names appearing on the standard input are copied. 

-r pax reads an archive file from the standard input. Only files 
with names that match any of the pattern operands are selected 
for extraction. The selected files are conditionally created and 
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copied relative to the current directory tree, subject to the 
options described below. By default, the owner and group of 
selected files will be that of the invoking process, and the per- 
missions and modification times will be the sames as those in 
the archive. 

The supported archive formats are automatically detected on 
input. The default output format is ustar, but may be overrid- 
den by the -x format option described below. 

-rw pax reads the files and directories named in the pathname 
operands and copies them to the destination directory . A direc- 
tory pathname operand refers to the files and (recursively) sub- 
directories of that directory. If no pathname operands are 
given, the standard input is read to get a list of pathnames to 
copy, one pathname per line. In this case, only those path- 
names appearing on the standard input are copied. The direc- 
tory named by the directory operand must exist and have the 
proper permissions before the copy can occur. 

If neither the -r or -w options are given, then pax will list the contents 
of the specified archive. In this mode, pax lists normal files one per 
line, hard link pathnames as 

pathname == linkname 

and symbolic link pathnames (if supported by the implementation) as 
pathname -> linkname 

where pathname is the name of the file being extracted, and linkname 
is the name of a file which appeared earlier in the archive. 

If the -V option is specified, then pax list normal pathnames in the 
same format used by the Is utility with the -1 option. Hard links are 
shown as 



<ls -/ listing> == linkname 
and symbolic links (if supported) are shown as 
<ls -I listing> -> linkname 



pax is capable of reading and writing archives which span multiple 
physical volumes. Upon detecting an end of medium on an archive 
which is not yet completed, pax will prompt the user for the next vol- 
ume of the archive and will allow the user to specify the location of 
the next volume. 
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Options 

The following options are available: 

-a The files specified by pathname are appended to the 

specified archive. 

-b blocking Block the output at blocking bytes per write to the 
archive file. A k suffix multiplies blocking by 1024, a b 
suffix multiplies blocking by 512 and a m suffix multi- 
plies blocking by 1048576 (1 megabyte). If not 
specified, blocking is automatically determined on input 
and is ignored for -rw. 

-c Complement the match sense of the the pattern 

operands. 

-d Intermediate directories not explicitly listed in the 

archive are not created. This option is ignored unless 
the -r option is specified. 

4 archive The archive option specifies the pathname of the input 

or output archive, overriding the default of standard 
input for -r or standard output for -w. 

-i Interactively rename files. Substitutions specified by -s 

options (described below) are performed before request- 
ing the new file name from the user. A file is skipped if 
an empty line is entered and pax exits with an exit status 
of 0 if EOF is encountered. 

-1 Files are linked rather than copied when possible. 

-m File modification times are not retained. 

-n When -r is specified, but -w is not, the pattern argu- 

ments are treated as ordinary file names. Only the first 
occurrence of each of these files in the input archive is 
read. The pax utility exits with a zero exit status after 
all files in the list have been read. If one or more files in 
the list is not found, pax writes a diagnostic to standard 
error for each of the files and exits with a non-zero exit 
status, the file names are compared before any of the -i, 
-s, or -y options are applied. 

-o Restore file ownership as specified in the archive. The 

invoking process must have appropriate privileges to 
accomplish this. 

-p Preserve the access time of the input files after they have 

been copied. 
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-t device 

-u 

-V 

•\ format 

cpio 

ustar 

-y 
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File names are modified according to the substitution 
expression using the syntax of ed(C) as shown: 

-s loldlnewl[gp] 

Any non null character may be used as a delimiter (a / is 
used here as an example). Multiple -s expressions may 
be specified; the expressions are applied in the order 
specified terminating with the first successful substitu- 
tion. The optional trailing p causes successful mappings 
to be listed on standard error. The optional trailing g 
causes the old expression to be replaced each time it 
occurs in the source string. Files that substitute to an 
empty string are ignored both on input and output. 

The device option argument is an implementation- 
defined identifier that names the input or ou^ut archive 
device, overriding the default of standard input for -r 
and standard output for -w. 

Copy each file only if it is newer than a pre-existing file 
with the same name. This implies -a. 

List file names as they are encountered. Produces a ver- 
bose table of contents listing on the standard output 
when both -r and -w are omitted, otherwise the file 
names are printed to standard error as they are encoun- 
tered in the archive. 

Specifies the output archive format. The input format, 
which must be one of the following, is automatically 
determined when the -r option is used. The supported 
formats are: 

The extended CPIO interchange format specified in 
Extended CPIO Format in IEEE Std. 1003.1-1988. 

The extended TAR interchange format specified in 
Extended TAR Format in IEEE Std. 1003.1-1988. This 
is the default archive format. 

Interactively prompt for the disposition of each file. 
Substitutions specified by -s options (described above) 
are performed before prompting the user for disposition. 
EOF or an input line starting with the character q 
caused pax to exit. Otherwise, an input line starting 
with anything other than y causes the file to be ignored. 
This option cannot be used in conjunction with the -i 
option. 



PAX-4 




PAX (C) 



PAX (C) 



Only the last of multiple -f or -t options take effect. 

When writing to an archive, the standard input is used as a list of path- 
names if no pathname operands are specified. The format is one path- 
name per line. Otherwise, the standard input is the archive file, which 
is formatted according to one of the specifications in 
Archive/Interchange File format in IEEE Std. 1003.1-1988, or some 
other implementation-defined format. 

The user ID and group ID of the process, together with the appropriate 
privileges, affect the ability of pax to restore ownership and permis- 
sions attributes of the archived files. (See format-reading utility in 
Archive/Interchange File Format in IEEE Std. 1003.1-1988 ) 

The options -a, -c, -d, -i, -1, -p, -t, -u, and -y are provided for func- 
tional compatibility with the historical cpio and tar utilities. The 
option defaults were chosen based on the most common usage of these 
options, therefore, some of the options have meanings different than 
those of the historical commands. 



Operands 

The following operands are available: 

directory The destination directory pathname for copies when 
both the -r and -w options are specified. The directory 
must exist and be writable before the copy or and error 
results. 

pathname A file whose contents are used instead of the files named 
on the standard input. When a directory is named, all of 
its files and (recursively) subdirectories are copied as 
well. 

pattern A pattern is given in the standard shell pattern matching 
notation. The default if no pattern is specified is *, 
which selects all files. 



Examples 



The following command 

pax -w -f /dev/rmtO . 

copies the contents of the current directory to tape drive 0. 

The commands 

mkdir newdir 
cd olddir 
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pax -rw . newdir 

copies the contents of olddir to newdir . 

The command 

pax -r -s *,//*usr//*„’ -f pax. out 

reads the archive pax.out with all files rooted in "/usr" in the archive 
extracted relative to the current directory. 

Files 



/dev/tty used to prompt the user for information when the -i or -y 
options are specified. 



See Also 



cpio(C), find(C), tar(C), cpio(M), tar(F) 

Diagnostics 

pax will terminate immediately, without processing any additional 
files on the command line or in the archive. 

pax will exit with one of the following values: 

0 All files in the archive were processed successfully. 

>0 pax aborted due to errors encountered during operation. 

Notes 



Special permissions may be required to copy or extract special files. 

Device, user ID, and group ID numbers larger than 65535 cause addi- 
tional header records to be output. These records are ignored by some 
historical version of cpio(C) and tar(C). 

The archive formats described in Archive/Interchange File Format 
have certain restrictions that have been carried over from historical 
usage. For example, there are restrictions on the length of pathnames 
stored in the archive. 

When getting an “Is -1” style listing on tar format archives, link 
counts are listed as zero since the ustar archive format does not keep 
link count information. 
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Copyright 

Copyright (c) 1989 Mark H. Colburn. 

All rights reserved. 

Redistribution and use in source and binary forms are permitted pro- 
vided that the above copyright notice is duplicated in all such forms 
and that any documentation, advertising materials, and other materials 
related to such distribution and use acknowledge that the software was 
developed by Mark H. Colburn and sponsored by The USENIX Asso- 
ciation. 

THE SOFTWARE IS PROVIDED “AS IS” AND WITHOUT ANY 
EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT 
LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTI- 
BILITY AND FITNESS FOR A PARTICULAR PURPOSE. 

Author 

Mark H. Colburn 

NAPS International 

117 Mackubin Street, Suite 1 

St. Paul, MN 55102 

mark@jhereg.MN.ORG 



Sponsored by The USENIX Association for public distribution. 
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pcpio 

copy file archives in and out 

Syntax 



pcpio -o[Bacv] 

pcpio -i[Bcdfmrtuv] [pattern...] 
pcpio -p[adlmruv] directory 

Description 



The pcpio utility produces and reads files in the format specified by 
the cpio Archive/interchange File Format specified in IEEE Std. 
1003.1-1988. 

The pcpio -i (copy in) utility extracts files from the standard input, 
which is assumed to be the product of a previous pcpio -o . Only files 
with names that match patterns are selected. Multiple patterns may 
be specified and if no patterns are specified, the default for patterns is 
selecting all files. The extracted files are conditionally created and 
copied into the current directory, and possibly any levels below, based 
upon the options described below and the permissions of the files will 
be those of the previous pcpio -o . The owner and group of the files 
will be that of the current user unless the user has appropriate 
privileges, which causes pcpio to retains the owner and group of the 
files of the previous pcpio -o . 

The pcpio -p (pass) utility reads the standard input to obtain a list of 
path names of files that are conditionally created and copied into the 
destination directory based upon the options described below. 

If an error is detected, the cause is reported and the pcpio utility will 
continue to copy other files, pcpio will skip over any unrecognized 
files which it encounters in the archive. 

The following restrictions apply to the pcpio utility: 

1 Pathnames are restricted to 256 characters. 

2 Appropriate privileges are required to copy special files. 

3 Blocks are reported in 512-byte quantities. 



Options 

The following options are available: 
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-B Input/output is to be blocked 5120 bytes to the record. Can 
only be used with pcpio -o or pcpio -i for data that is directed 
to or from character special files. 

-a Reset access times of input files after they have been copied. 
When the -1 option is also specified, the linked files do not have 
their access times reset. Can only be used with pcpio -o or 
pcpio -i . 

-c Write header information in ASCII character for for portability. 
Can only be used with pcpio -i or pcpio -o . Note that this 
option should always be used to write portable files. 

-d Creates directories as needed. Can only be used with pcpio -i 
or pcpio -p . 

-f Copy in all files except those in patterns . Can only be used 
with pcpio -i . 

-1 Whenever possible, link files rather than copying them. Can 
only be used with pcpio -p . 

-m Retain previous modification times. This option is ineffective 
on directories that are being copied. Can only be used with 
pcpio -i or pcpio -p . 

-r Interactively rename files. The user is asked whether to rename 
pattern each invocation. Read and write permissions for 
/dev/tty are required for this option. If the user types a null 
line, the file is skipped. Should only be used with pcpio -i or 
pcpio -o . 

-t Print a table of contents of the input. No files are created. Can 
only be used with pcpio -i . 

-u Copy files unconditionally; usually an older file will not 
replace a new file with the same name. Can only be used with 

pcpio -i or pcpio -p . 

-V Verbose: cause the names of the affected files to be printed. 
Can only be used with pcpio -i . Provides a detailed listing 
when used with the -t option. 
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Operands 

The following operands are available: 

patterns Simple regular expressions given in the name-generating 
notation of the shell. 

directory The destination directory. 



Exit Status 

The pcpio utility exits with one of the following values: 

0 All input files were copied. 

2 The utility encountered errors in copying or accessing files or 
directories. An error will be reported for nonexistent files or 
directories, or permissions that do not allow the user to access 
the source or target files. 

It is important to use the -depth option of the find utility to generate 
pathnames for pcpio . This eliminates problems pcpio could have try- 
ing to create files under read-only directories. 

The following command: 

Is I pcpio -o > ../new file 

copies out the files listed by the Is utility and redirects them to the file 

newfile . 

The following command: 

cat newfile I pcpio -id "memo/al” "memo/b*" 

uses the output file newfile from the pcpio -o utility, takes those files 
that match the patterns memo/al and memo/b* , creates the direc- 
tories below the current directory, and places the files in the appropri- 
ate directories. 

The command 

find . -depth -print I pcpio -pdlmv newdir 

takes the file names piped to it from the find utility and copies or links 
those files to another directory named newdir , while retaining the 
modification time. 
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/dev/tty used to prompt the user for information when the -i or -r 
options are specified. 



See Also 



find(C), pax(C), tar(C), tar(F) 

Copyright 



Copyright (c) 1989 Mark H. Colburn. 

All rights reserved. 

Redistribution and use in source and binary forms are permitted pro- 
vided that the above copyright notice is duplicated in all such forms 
and that any documentation, advertising materials, and other materials 
related to such distribution and use acknowledge that the software was 
developed by Mark H. Colburn and sponsored by The USENIX Asso- 
ciation. 

THE SOFTWARE IS PROVIDED “AS IS” AND WITHOUT ANY 
EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT 
LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTI- 
BILITY AND HTNESS FOR A PARTICULAR PURPOSE. 

Author 



Mark H. Colburn 

NAPS International 

117 Mackubin Street, Suite 1 

St. Paul, MN 55102 

mark@jhereg.MN.ORG 



Sponsored by The USENIX Association for public distribution. 

Standards Conformance 



pcpio is conformant with: 

IEEE POSIX Std 1003.1-1988 with C Standard Language-Dependent 
System Support; 
and NIST FIPS 151-1. 
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pg 

file perusal filter for soft-copy terminals 

Syntax 

pg [- number ] [-p string ] [-cefns] [+ linenumber ] [+/ pattern /] 
[ files ...] 

Description 



The pg command is a filter which allows the examination of files one 
screenful at a time on a soft-copy terminal. (The dash (-) command 
line option and/or NULL arguments indicate that pg should read from 
the standard input.) Each screenful is followed by a prompt. If you 
press the RETURN key, another page is displayed; other possibilities 
are listed below. This command is different from previous paginators 
because it allows you to back up and review something that has 
already passed. 

To determine terminal attributes, pg scans the termcap{¥) data base 
for the terminal type specified by the environment variable TERM. If 
TERM is not defined, the terminal type dumb is assumed. 

The command line options are: 

-number Specifies the size (in lines) of the window that pg is to 
use instead of the default. (On a terminal containing 24 
lines, the default window size is 23.) 

-p string Causes pg to use string as the prompt. If the prompt 
string contains a “%d”, the first occurrence of “%d” 
in the prompt will be replaced by the current page num- 
ber when the prompt is issued. The default prompt 
string is a colon (:). 

-c Homes the cursor and clears the screen before display- 

ing each page. This option is ignored if clear screen 
is not defined for this terminal type in the termcap(F) 
data base. 

-e Causes pg not to pause at the end of each file. 

-f Inhibits pg from splitting lines. In the absence of the -f 

option, pg splits lines longer than the screen width, but 
some sequences of characters in the displayed text (for 
example, escape sequences for underlining) give 
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undesirable results. 

-n Normally, commands must be terminated by pressing 

the RETURN key (ASCII newline character). This 
option causes an automatic end of command as soon as 
a command letter is entered. 

-s Causes pg to display all messages and prompts in stan- 

dout mode (usually inverse video). 

+linenumber Starts up at linenumber , 

+lpatternl Starts up at the first line containing the regular expres- 
sion pattern. 

The responses that may be entered when pg pauses can be divided into 
three categories: those that cause further perusal, those that search, 
and those that modify the perusal environment. 

Commands which cause further perusal normally take a preceding 
address (an optionally signed number indicating the point from which 
further text should be displayed), pg interprets this address in either 
pages or lines depending on the command. A signed address specifies 
a point relative to the current page or line, and an unsigned address 
specifies an address relative to the beginning of the file. Each com- 
mand has a default address if no address is provided. 

The perusal commands and their defaults are as follows: 

(+l)RETURNkey 

Causes one page to be displayed. The address is specified in 
pages. 

(+1)1 

With a signed address, causes pg to simulate scrolling the screen, 
forward or backward, the number of lines specified. With an 
unsigned address this command displays a full screen of text 
beginning at the specified line. 

(+1) d or Ctrl-D 

Simulates scrolling half a screen forward or backward. 

The following perusal commands take no address : 

. or Ctrl-L 

Causes the current page of text to be redisplayed. 

$ Displays the last window full in the file. Use with caution when 
the input is a pipe. 
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The following commands are available for searching for text patterns 
in the text. The regular expressions described in ed{C) are available. 
They must always be terminated by a newline character, even if the -n 
option is specified. 

H pattern ! 

Search forward for the ith (default /=1) occurrence of pattern. 
Searching begins immediately after the current page and continues 
to the end of the current file, without wrap-around. 

r pattern" 
il pattern! 

Search backwards for the ith (default /=1) occurrence of pattern. 
Searching begins immediately before the current page and contin- 
ues to the beginning of the current file, without wrap-around. The 
caret Q notation is useful for terminals which will not properly 
handle the question mark (?). 

After searching, pg displays the line found at the top of the screen. 
You can modify this by appending m or b to the search command to 
leave the line found in the middle or at the bottom of the window from 
now on. Use the suffix t to restore the original situation. 

The following commands modify the environment of perusal: 

in Begins perusing the ith next file in the command line. The 
default value of / is 1. 

ip Begins perusing the ith previous file in the command line. 
The default value of / is 1 . 

/w Displays another window of text. If i is present, set the win- 
dow size to i. 

s filename 

Saves the input in the named file. Only the current file being 
perused is saved. The white space between the s and filename 
is optional. This command must always be terminated by a 
newline character, even if the -n option is specified. 

h Help displays abbreviated summary of available commands. 

qorQ Quitp^. 

I command 

command is passed to the shell, whose name is taken from the 
SHELL environment variable. If this is not available, the 
default shell is used. This command must always be ter- 
minated by a newline character, even if the -n option is 
specified. 
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At any time when output is being sent to the terminal, the user can 
press the quit key (normally Ctrl-\) or the INTERRUPT (BREAK) key. 
This causes pg to stop sending output, and display the prompt. The 
user may then enter one of the above commands in the normal manner. 
Unfortunately, some output is lost when this is done, because any 
characters waiting in the terminal’s output queue are flushed when the 
quit signal occurs. 

If the standard output is not a terminal, then pg acts just like cat(C), 
except that a header is printed before each file (if there is more than 
one). 



Example 



To use pg to read system news, enter: 


news 1 


pg -p “(Page %d):” 


Files 




/etc/termcap 


Terminal information data base 


/tmp/pg* 


Temporary file when input is from a pipe 


See Also 




ed(C), grep(C), termcap(M) 


Notes 





If terminal tabs are not set every eight positions, undesirable results 
may occur. 

When using pg as a filter with another command that changes the ter- 
minal I/O options terminal settings may not be restored correctly. 

While waiting for terminal input, pg responds to "BREAK and DEL" by 
terminating execution. Between prompts, however, these signals 
interrupt pg's current task and place you in prompt mode. Use these 
signals with caution when input is being read from a pij^, since an 
interrupt is likely to terminate the other commands in the pipeline. 

The z and /commands used with more are available, and the terminal 
slash (/), caret Q, or question mark (?) may be omitted from the 
searching commands. 
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pg is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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pr 

prints files on the standard output 

Syntax 

pr [ options ] [ files ] 

Description 



pr prints the named files on the standard output. If file is or if no 
files are specified, the standard input is assumed. By default, the list- 
ing is separated into pages, each headed by the page number, date and 
time, and the name of the file. 

By default, columns are of equal width, separated by at least one 
space; lines which do not fit are truncated. If the -s option is used, 
lines are not truncated and columns are separated by the separation 
character. 

If the standard output is associated with a terminal, error messages are 
withheld until pr has completed printing. 

Options may appear singly or combined in any order. Their meanings 
are: 

+k Begins printing with page k (default is 1). 

-k Produces A: -column output (default is 1). The options -e and -i 

are assumed for multicolumn output. 

-a Prints multicolumn output across the page. 

-m Merges and prints all files simultaneously, one per column 
(overrides the -k, and -a options). 

-d Double- spaces the output. 

-ecfc Expands input tabs to character positions ^+1, 2*^+1, 3*A:+1, 
etc. If is 0 or is omitted, default tab settings at every 8th posi- 
tion are assumed. Tab characters in the input are expanded inio 
the appropriate number of spaces. If c (any nondigit character) 
is given, it is treated as the input tab character (default for c is 
the tab character). 

-ic^ In output, replaces whitespace wherever possible by inserting 
tabs to character positions ^+1, 2*A:+1, 3*^+1, etc. If A: is 0 or 
is omitted, default tab settings at every 8th position are 
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assumed. If c (any nondigil character) is given, it is treated as 
the output tab character (default for c is the tab character). 

-nc^ Provides A: -digit line numbering (default for k is 5). The number 
occupies the first k+\ character positions of each column of nor- 
mal output or each line of -m output. If c (any nondigit charac- 
ter) is given, it is appended to the line number to separate it 
from whatever follows (default for c is a tab). 

-w^ Sets the width of a line to k character positions (default is 72 for 
equal-width multicolumn output, no limit otherwise). 

•ok Offsets each line by k character positions (default is 0). The 
number of character positions per line is the sum of the width 
and offset. 

•\k Sets the length of a page to k lines (default is 66). 

-h Uses the next argument as the header to be printed instead of 
the filename. 

-p Pauses before beginning each page if the output is directed to a 
terminal {pr will ring the bell at the terminal and wait for a car- 
riage return). 

-f Uses form feed character for new pages (default is to use a 
sequence of linefeeds). Pauses before beginning the first page if 
the standard output is associated with a terminal. 

-r Prints no diagnostic reports on failure to open files. 

-t Prints neither the 5-line identifying header nor the 5-line trailer 
normally supplied for each page. Quits printing after the last 
line of each file without spacing to the end of the page. 

-sc Separates columns by the single character c instead of by the 
appropriate number of spaces (default for c is a tab). 
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The following prints filel and Jile2 as a double-spaced, three-column 
listing headed by “file list”: 

pr -3dh ’’file list” filel file2 

The following writes filel on file!, expanding tabs to columns 10, 19, 
28, 37,...: 

pr -e9 -t <filel >file2 

See Also 



cat(C) 

Standards Conformance 



pr is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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ps 

reports process status 

Syntax 

ps [ options ] 

Description 



ps prints certain information about active processes. Entering ps 
without any options calls up information about processes associated 
with the current terminal. The following options control the amount 
and type of information displayed. 

Options 



-e Prints information about all processes. 

-d Prints information about all processes, except process 

group leaders. 

-a Prints information about all processes, except process 

group leaders and processes not associated with a ter- 
minal. 

-f Generates a full listing. Normally, a short listing con- 

taining only process ID, terminal (“tty”) identifier, 
cumulative execution time, and the command name is 
printed. Under the -f option, ps tries to determine and 
print the process’ original command name and argu- 
ments. If it cannot, it prints the short listing version of 
the command name within square brackets. See below 
for the meaning of columns in a full listing. 

-1 Generates a long listing, including status, priority, loca- 

tion, and memory usage information for each process. 

-t tlist Restricts listing to data about the processes associated 

with the terminals given in tlist, where tlist can be in 
one of two forms: a list of terminal identifiers 
separated from one another by a comma, or a list of ter- 
minal identifiers enclosed in double quotes and 
separated from one another by a comma and/or one or 
more spaces. 
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-p plist Restricts listing to data about processes whose process 
ID numbers are given in plist, where plist is in the same 
format as tlist. 

-u ulist Restricts listing to data about processes whose user ID 
numbers or login names are given in ulist, where ulist 
is in the same format as tlist . In the listing, the numeri- 
cal user ID is printed unless the -f option is used, in 
which case the login name is printed. 

-g glist Restricts listing to data about processes whose process 
groups are given in glist, where glist is a list of process 
group leaders and is in the same format as tlist , 

-n namelist The argument is taken as the name of an alternate 
namelist (/unix is the default). 

Display Columns 

The column headings and the meaning of the columns in a ps listing 
are given below; the letters f and 1 indicate the option (full or long) 
that causes the corresponding heading to appear; all means that the 
heading always appears. Note that these two options only determine 
what information is provided for a process; they do not determine 
which processes will be listed. 

F (1) A status word consisting of flags associated with 

the process. Each flag is associated with a bit in 
the status word. These flags are added to form a 
single octal number. Process flag bits and their 
meanings are: 

01 in core; 

02 system process; 

04 locked in core (e.g., for physical I/O); 

10 being swapped; 

20 being traced by another process. 

S (1) The State of the process: 

0 non-existent; 

5 sleeping; 

R running; 

1 intermediate; 

Z terminated; 

T stopped; 

B waiting. 
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UID 


(f.i) 


The user ID number of the process owner; the log- 
in name is printed under the -f option. Login 
names are truncated after 7 characters. 


PID 


(all) 


The process ID; used when killing a process (see 
kill(C)), 


PPID 


(f,l) 


The process ID of the parent process. 


C 


(f.l) 


Processor utilization for scheduling. 


STIME 


(f) 


Starting time of the process. 


PRI 


(1) 


The priority of the process; higher numbers mean 
lower priority. 


NI 


(1) 


Nice value; used in priority computation. 


ADDRl, 
ADDR2 (1) 


The memory addresses (physical page frame num- 
bers) of u-area of the process, if resident; other- 
wise, the disk address. ADDRl gives the frame 
number of the first half of the u-area, and ADDR2 
gives the number of the second half. 


sz 


(1) 


The size in blocks of the core image of the pro- 
cess, but not including the size of text shared with 
other processes. Since this size includes the 
current size of the stack, it will vary as the stack 
size varies. 


WCHAN(l) 


The event for which the process is waiting or 
sleeping; if blank, the process is running. 


TTY 


(all) 


The controlling terminal for the process. 


TIME 


(all) 


The cumulative execution time for the process. 


CMD 


(all) 


The command name; the full command name and 
its arguments are printed under the -f option. 



A process that has exited and has a parent, but has not yet been waited 
for by the parent, is marked <defunct>. 



Files 



/unix system namelist 
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/dev/mem memory 

/dev searched to find swap device and terminal (“tty”) names. 

See Also ' 

kill(C), nice(C) 

Notes 

Things can change while ps is running; the picture it gives is only a 
close approximation to the current system state. 

Some data printed for defunct processes are irrelevant. 

Authorization 



The behavior of this utility is affected by assignment of the mem 
authorization, which is usually reserved for system administrators, If 
you do not have this authorization, the output will be restricted to data 
pertaining to your activities only. Refer to the “Using a Trusted Sys- 
tem” chapter of the User*s Guide for more details. 

Standards Conformance 



ps is conformant with: 

AT&T SVID Issue 2, Select Code 307 All; 

and The X/Open Portability Guide II of January 1987. 
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pscat 

ASCII-to-PostScript filter 

Syntax 

/usr/altos/bin/pscat [-C] [-1 mm] 

Description 



The pscat utility is a simple filter that converts ASCII text to 
PostScript®. This utility takes its input from standard input and pro- 
duces output to standard output. Typically, pscat is used in an lp(C) 
printer interface script to prepare ordinary text files for printing on a 
PostScript printer. 

pscat recognizes most PostScript files. So, if a PostScript file is used 
as input, the text passes through unmodified. Unrecognized files can 
be forced through with the -C option. 

The -I mm option allows non-standard paper sizes, where num is the 
number of lines per page. The default is 66. 

See Also 



lp(C) 

Value Added 



pscat is an extension of AT&T System V provided by Altos UNIX Sys- 
tem V. 
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pstat 

reports system information 

Syntax 

pstat [ -aipf ] [ -u ubasel ubase2 ] [ -n namelist ] [ file ] 

Description 

pstat interprets the contents of certain system tables, pstat searches 
for these tables in /dev/mem and /dev/kmem. With the file given, the 
tables are sought in the specified file rather than /dev/mem. The 
required namelist is taken from /unix. Options are: 

-a Under -p, describe all process slots rather than just active 
ones. 

4 Print the inode table with these headings: 

LOG The core location of this table entry. 

FLAGS Miscellaneous state variables encoded thus: 

L Locked 

U Update time filesystem (F) must be corrected 
A Access time must be corrected 
M File system is mounted here 
W Wanted by another process (L flag is on) 

T Contains a text file 
C Changed time must be corrected 
CNT Number of open file table entries for this inode. 

DEV Major and minor device number of file system in 

which this inode resides. 

INO I-number within the device. 

MODE Mode bits, see chmod(S), 

NLK Number of links to this inode. 

UID User ID of owner. 

SIZ/DEV 

Number of bytes in an ordinary file, or major and 
minor device of special file. 

-p Prints process table for active processes with these head- 
ings: 

LOC The core location of this table entry. 

S Run state encoded thus: 

0 No process 

1 Waiting for some event 
3 Runnable 
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4 Being created 

5 Being terminated 

6 Stopped under trace 

F Miscellaneous state variables, ORed together: 

01 Loaded 

02 The scheduler process 
04 Locked 

010 

Swapped out 
020 
Traced 
040 

Used in tracing 
0100 

Locked in by lock(S). 

PRI Scheduling priority, see nice (S). 

SIGNAL Signals received (signals 1-16 coded in bits 0-15). 
UID Real user ID. 

TIM Time resident in seconds; times over 127 coded as 
127. 

CPU Weighted integral of CPU time, for scheduler. 

NI Nice level, see nice(S). 

PGRP Process number of root of process group (the 
opener of the controlling terminal). 

PID The process ID number. 

PPID The process ID of parent process. 

ADDR1,ADDR2 

If in core, the physical page frame numbers of the 
u-area of the process. These numbers can be 
translated into the addresses of the u-area, which 
is split and stored in two pages. If swapped out, 
the position in the swap area is measured in multi- 
ples of BSIZE bytes. 

WCHAN 

Wait channel number of a waiting process. 

LINK Link pointer in list of runnable processes. 

TEXTP If text is pure, pointer to location of text table 
en^ (286 only). 

INODP Pointer to location of shared inode (386 only). 
CLKT Countdown for alarm(S) measured in seconds. 

-u ubasel ubase2 

Print information about a user process. Ubasel and Ubase2 
are the physical page frame numbers of the u-area of the 
process. The numbers may be obtained by using the long 
listing ( -1 option) of the ps{C) command. 

-n namelist 

Use the file namelist as an alternate namelist in place of 
/unix. 
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-f Print the open file table with these headings: 

LOC The core location of this table entry. 

FLG Miscellaneous state variables: 

R Open for reading 
W Open for writing 
P Pipe 

CNT Numter of processes that know this open file. 

INO The location of the inode table entry for this file. 
OFFS The file offset, see IseekiS). 

Files 



/unix Namelist 
/dev/mem Default source of tables 

See Also 



ps(C), stat(S), filesystem(F) 

Authorization 



The behavior of this utility is affected by assignment of the mem 
authorization, which is usually reserved for system administrators. If 
you do not have this authorization, the output will be restricted to data 
pertaining to your activities only. Refer to the “Using a Trusted Sys- 
tem” chapter of the User's Guide for more details. 

Value Added 



pstat is an extension of AT&T System V provided by Altos UNIX Sys- 
tem V. 
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ptar 

process tape archives 

Syntax 



ptar -c[bfvw] device block filename... 

ptar -r[bvw] device block [filename...] 

ptar -t[fv] device 

ptar -u[bvw] device block 

ptar -xfflmovw] device [filename...] 

Description 



Tar reads and writes archive files which conform to the 
Archive/Interchange File Format specified in IEEE Std. 1003.1- 
1988. 



Options 

The following options are available: 

-c Creates a new archive; writing begins at the beginning 

of the archive, instead of after the last file. 

-r Writes names files to the end of the archive. 

-t Lists the names of all of the files in the archive. 

-u Causes named files to be added to the archive if they are 

not already there, or have been modified since last writ- 
ten into the archive. This implies the -r option. 

-X Extracts named files from the archive. If a named file 

matches a directory whose contents had been written 
onto the archive, that directory is recursively extracted. 
If a named file in the archive does not exist on the sys- 
tem, the file is create with the same mode as the one in 
the archive, except that the set-user-id and get-group-id 
modes are not set unless the user has appropriate 
privileges. 

If the files exist, their modes are not changed except as described 
above. The owner, group and modification time are restored if possi- 
ble. If no filename argument is given, the entire contents of the 
archive is extracted. Note that if several files with the same name are 
in the archive, the last one will overwrite all earlier ones. 
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-b 



-f 



-1 



-m 



-o 



-V 



-w 



Files 



Causes ptar to use the next argument on the command 
line as the blocking factor for tape records. The default 
is 1; the maximum is 20. This option should only be 
used with raw magnetic tape archives. Normally, the 
block size is determined automatically when reading 
tapes. 

Causes ptar to use the next argument on the command 
line as the name of the archive instead of the default, 
which is usually a tape drive. If - is specified as a 
filename ptar writes to the standard output or reads from 
the standard input, whichever is appropriate for the 
options given. Thus, ptar can be used as the head or tail 
of a pipeline. 

Tells ptar to report if it cannot resolve all of the links to 
the files being archived. If -1 is not specified, no error 
messages are written to the standard output. This 
modifier is only valid with the -c, -r and -u options. 

Tells ptar not to restore the modification times. The 
modification time of the file will be the time of extrac- 
tion. This modifier is invalid with th -t option. 

Causes extracted files to take on the user and group 
identifier of the user running the program rather than 
those on the archive. This modifier is only valid with the 
-X option. 

Causes ptar to operate verbosely. Usually, ptar does its 
work silently, but the v modifier causes it to print the 
name of each file it processes, preceded by the option 
letter. With the -t option, v gives more information 
about the archive entries than just the name. 

Causes ptar to print the action to be taken, followed by 
the name of the file, and then wait for the user’s 
confirmation. If a word beginning with y is given, the 
action is performed. Any other input means “no”. This 
modifier is invalid with the -t option. 



/dev/tty used to prompt the user for information when the -i or -y 
options are specified. 



See Also 



cpio(C), dd(C), find(C), pax(C), pcpio(C) 
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Copyright 



Copyright (c) 1989 Mark H. Colburn. 

All rights reserved. 

Redistribution and use in source and binary forms are permitted pro- 
vided that the above copyright notice is duplicated in all such forms 
and that any documentation, advertising materials, and other materials 
related to such distribution and use acknowledge that the software was 
developed by Mark H. Colburn and sponsored by The USENIX Asso- 
ciation. 

THE SOFTWARE IS PROVIDED “AS IS” AND WITHOUT ANY 
EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT 
LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTI- 
BILITY AND FITNESS FOR A PARTICULAR PURPOSE. 

Author 



Mark H. Colburn 
NAPS International 
117 Mackubin Street, Suite 1 
St. Paul, MN 55102 
mark@ jhereg .MN.ORG 



Sponsored by The USENIX Association for public distribution. 

Standards Conformance 



ptar is conformant with: 

IEEE POSIX Std 1003.1-1988 with C Standard Language-Dependent 
System Support; 
and NIST FIPS 151-1. 
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purge 

overwrites specified files 

Syntax 



purge [ -f ] [ -r ] [ -V ] [ -m num ] [ -suo ] [ -t type ] ... [ -z ] [ files ] ... 



Description 



The command is used to overwrite various parts of the system. It 
overwrites files specified on the command line, or those listed in a 
policy file maintained by the system administrator. The policy file 
defines types of files and devices which are purged as a group. The 
utility can be used to purge individual files, divvy(ADM) divisions, 
fdisk(ADM) partitions, or other devices like magnetic tapes and flop- 
pies. An option even exists to zero memory. 

The optional flags are outlined below: 

-f Do not warn about files which are not present or inaccessi- 

ble. Attempts to purge a floppy which is inaccessible (e.g., 
the door is open) will always generate a diagnostic on the 
system console. 

-r Recursively purge directories. Without this flag no action is 

taken upon directories. 

-v Verbose operation, list the name of each file as it is 

overwritten. 

-m num Overwrite each file num times. 

-s Overwrite files and devices designated as “system” in the 

policy file. (Equivalent to “-t system”.) 

-u Overwrite files and devices designated as “user” in the 

policy file. (Equivalent to “-t user”.) 

-o Overwrite other (non-system and non-user) files and 

filesystems. This purges all entries in the policy file which 
are not of either type system or user. This flag, by the 
nature of its implicit definition, has no “-t” equivalent. 
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-t type Overwrite the files identified in the policy file as being part 
of group type. 

-z Writes binary zeroes to system memory, including memory 

buffers of intelligent devices (i.e. disk controller cache, 
etc.). This will close down the system immediately. This 
should only be done from single-user mode, or when no 
users are logged on. The system will autoboot if so config- 
ured (see autoboot(}A)). Only the superuser may use this 
option. 

files Regular, directory or special files to purge. 

Similarly to regular files, most special files can be purged by being 
placed in the policy file or with the command purge ht\! special Jile. 
Block special files and some character special files can be overwritten. 
The console, ttys, printers and other infinite output devices cannot be 
purged with this command. Disks, floppies and magnetic tapes can be 
overwritten. Tape devices are first erased once and then overwritten 
the specified number of times. 

When both types and files are specified on the command line, all of the 
indicated files are overwritten by the utility. In particular, first the files 
selected from the policy file, and then those specified on the command 
line, are overwritten. 

Each line in the policy file (/etc/default/purge) designates a file, 
filesystem or device as a member of some type. The syntax of a line is: 

file type [ count ] 

The optional count field is the number of times to overwrite file. The 
default count is one. The utility will overwrite file any time the com- 
mand 

purge -t type 

is given. 

Blank lines in the policy file and lines beginning with ‘#’ are ignored. 



Files 



/etc/default/purge 


The policy file 


See Also 





autoboot(ADM), dd(C), hd(C), od(C), rm(C), purge(F), 
sysadtnsh(ADM) 
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PURGE (C) 

Diagnostics 



PURGE (C) 



purge: warning: invalid entry in policy file (line n) 

An invalid line was read from the policy file where n is the number of 
the incorrectly formatted line. 

purge: filename is a directory 

If the -r switch is not specified no action is taken upon directories and 
this diagnostic is displayed. 

purge: only the superuser can zero memory 

This message is displayed when a user other than the superuser tries to 
use the -z option. 

Notes 



When files are overwritten multiple times, the first pass writes binary 
zeros. Subsequent passes alternate writing binary ones and binary 
zeros. 

After being overwritten, od(C\ dd(C) or hd{C) may be used to verify 
that no data remains on the device or in the file. 

Only the superuser may use the -z option to zero the system’s memory. 

Value Added 



purge is an extension of AT&T System V provided by Altos UNIX 
System V. 
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pwcheck 

checks password file 

Syntax 



pwcheck [file] 

Description 



pwcheck scans the password file and checks for any inconsistencies. 
The checks include validation of the number of fields, login name, 
user ID, group ID, and whether the login directory and optional pro- 
gram name exist. The default password file is /etc/passwd. 

Fiies 



/etc/passwd 

See Aiso 



grpcheck(C), group(F), passwd(F) 
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pwd 

prints working directory name 

Syntax 



pwd 

Description 



pwd prints the pathname of the working (current) directory. 

See Aiso 

cd(C) 

Diagnostics 



“Cannot open and “Read error in indicate possible file system 
trouble. In such cases, see the System Administrator's Guide for infor- 
mation on fixing the filesystem. 

Standards Conformance 



pwd is conformant with: 

AT&TSVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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quot 

summarizes file system ownership 

Syntax 

quot [ option ] ... [ filesystem ] 

Description 



quot prints the number of blocks in the named filesystem currently 
owned by each user. If no filesystem is named, the file systems given 
in /etc/mnttab are examined. 

The following options are available: 

-n Processes standard input. This option makes it possible to produce 
a list of all files and their owners with the following command: 

ncheck filesystem I sort +0n I quot -n filesystem 

-c Prints three columns giving file size in blocks, number of files of 
that size, and cumulative total of blocks in that size or smaller file. 
Data for files of size greater than 499 blocks are included in the 
figures for files of exactly size 499. 

-f Prints a count of the number of files as well as space owned by 
each user. 

Files 



/etc/passwd Gets user names 

/etc/mnttab Contains list of mounted file systems 

See Also 

cmchk(C), du(C), ls(C), machine(HW) 

Notes 

Holes in files are counted as if they actually occupied space. 
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Blocks are reported in 512 byte blocks. 
See also Notes under mount{PiDM). 
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random 

generates a random number 

Syntax 

random [-s] [ scale ] 

Description 



random generates a random number on the standard output, and 
returns the number as its exit value. By default, this number is either 
0 or 1 (i.e., scale is 1 by default). If scale is given a value between 1 
and 255, then the range of the random value is from 0 to scale. If scale 
is greater than 255, an error message is printed. 

When the -s , “silent” option is given, the random number is returned 
as an exit value but is not printed on the standard output. If an error 
occurs, random returns an exit value of zero. 

See Aiso 



rand(S) 

Notes 



This command does not perform any floating point computations. 
random uses the time of day as a seed. 
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rep 

copies files across systems 

Syntax 

rep [options ] [srcmachine:]srcfile [destmachine:]destfile 

Description 



rep copies files between systems in a Micnet network. The command 
copies the srcmachine:srcfile to destmachine:destfile , where srema- 
chine: and destmachine: are optional names of systems in the net- 
work, and srcfile and destfile are pathnames of files. If a machine 
name is not given, the name of the current system is assumed. If - is 
given in place of srcfile , rep uses the standard input as the source. 
Directories named on the destination machine must have write per- 
mission, and directories and files named on a remote source machine 
must have read permission. 

The available options are: 

-m 

Mails and reports completion of the command, whether there is an 
error or not. 

-u [machine:]user 

Any mail goes to the named user on machine. The default ma- 
chine is the machine on which the rep command is completed or 
on which an error was detected. If an alias for user exists in the 
system alias files on that machine , the mail will be redirected to 
the appropriate mailbox(es). Since system alias files are usually 
identical throughout the network, any specified machine will most 
likely be overridden by the aliasing mechanism. To prevent alias- 
ing, user must be escaped with at least two \ characters (at least 
four if given as a shell command). 
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rep is useful for transferring small numbers of files across the network. 
The network consists of daemons that periodically awaken and send 
files from one system to another. The network must be installed using 
netutil (ADM) before rep can be used. 

Also, to enable transfer of files from a remote system, either: 

This line should be in letel default! mienet on the systems in the net- 
work: 



rcp=/usr/bin/rcp 

Or, these lines should be in that file: 

executeall 
execpath=P ATH = path 

where path must contain lusribin. 

Example 



rep -m machine l:/etc/mnttab /tmp/vtape 

See Also 



mail(C), micnet(F), netutil(ADM), remote(C) 

Diagnostics 



If an error occurs, mail is sent to the user. 

Notes 



Full pathnames must be specified for remote files. 

rep handles binary data files transparently, no extra options or proto- 
cols are needed to handle them. Wildcards are not expanded on the 
remote machine. 



March 15, 1989 



RCP-2 






RCVTRIP(C) 



RCVTRIP (G) 



rcvtrip 

notifies mail sender that recipient is away 

Syntax 



/usr/bin/rcvtrip [-d] [address] 

Description 



The rcvtrip command makes it possible for you to notify the sender of 
a message that you are on holiday and you won’t be answering your 
mail for some time. MMDF runs rcvtrip on your behalf rather than by 
you directly. 

To enable use of rcvtrip, put the following line in your .maildelivery 
file: 



* - pipe R rcvtrip $ (sender) 

Make sure that your .maildelivery file is not writable by anyone but 
you. You may also place a “custom” reply message in a file named 
tripnote. Finally, you should create an empty triplog file. 

When rcvtrip processes a message, it performs the following steps: 

1 . Decide if this type of message should receive a reply. 

2. Decide to whom the reply should be sent. 

3. Decide whether this sender has already gotten a reply. 

The rcvtrip command decides whether this is the type of message that 
should get a reply by looking at the contents of the "Resent-To:", 
"Resent-Cc:”, "To:" and "Cc:" header fields. If the recipient has an 
.alter_egos file (described next), then one of the addresses in that file 
must appear in the one of these header fields for a reply to be sent. If 
the recipient does not have an .alter_egos file, then the recipient’s 
name or a first-order alias of the recipient’s name (for example, 
dlong->long) must appear in one of these header fields for a reply to 
be sent. This procedure ensures that rcvtrip will not reply to messages 
sent to mailing lists, unless the recipient’s name (or some variant of 
the recipient’s name) is explicitly mentioned in a header field. 

If rcvtrip has decided that it should send a reply for the message, then 
it looks at several other address fields to determine to whom the reply 
should be sent. It uses, in order of precedence: 
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1. addresses in ‘Resent- Reply-To:’ 

2. addresses in ‘Resent-From:’ and, if present, ‘Resent- Sender:’ 

3. addresses in ‘Reply-To:’ 

4. addresses in ‘From:’ and either ‘Sender:’, if present, or the 
address argument from the command line. 

The rcvtrip command notifies any originator of mail who has not pre- 
viously been notified unless you pre-load their address into the triplog 
file (refer to the Files section). The reply begins with some standard 
text (supplied by rcvtrip) followed by whatever text the user has 
placed in the tripnote file (or a canned message if the tripnote file is 
missing). The originators’ names are recorded in triplog, along with 
the date and time the message came in, an indication of whether it was 
answered (‘+’=yes), and the first few characters of the subject. This 
appears as: 

+ jpo0nott.ac.uk Wed Oct 8 16:08 » about your last message 

Files 



$HOME/tripnote contains a reply message to be sent to those sending 
you mail. 

$HOME/triplog contains a list of who sent a message, what was its 
subject, when it arrived, and if a response was sent. It can also be ini- 
tialized by hand to contain the addresses, one per line, which are not 
to receive replies. 

$HOME/logfile, it it exists, becomes an output file for logging diag- 
nostic information. If the -d option is specified, then extensive output 
is generated for debugging purposes. It is not a good idea to leave -d 
enabled if this file is left lying around, as the output can be quite 
voluminous. 

$HOME/.alter_egos, an optional file composed of ‘user@domain’ 
lines for all addresses to be considered ‘you’. This is needed if you 
have multiple hosts forwarding their mail to you. If this file is present, 
then the standard comparisons against your username and first-level 
aliases of your username do not occur. 

$HOME/.maildelivery is your mail delivery specification file. The 
previous example shows the line that should be added to .mail- 
delivery to enable use of rcvtrip. In this line, the $(sender) argument 
is optional (but recommended). You may need to give the full path- 
name of rcvtrip if it is not in your search path. 
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See Also 



RCVTRIP (C) 



maildelivery(F) 
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remote 

executes commands on a remote system 

Syntax 



remote [ - ] [ -f file ] [ -m ] [ -u user] machine 
command [ arguments ] 

Description 



remote is a limited networking facility that permits execution of Altos 
UNIX System V commands across serial lines. Commands on any 
connected system may be executed from the host system using remote. 
A command line consisting of command and any blank-separated 
arguments is executed on the remote machine . A machine’s name is 
located in the file /etc/systemid. Note that wild cards are not 
expanded on the remote machine, so they should not be specified in 
arguments. The optional -m switch causes mail to be sent to the user 
telling whether the command is successful. 

The available options follow: 

A dash signifies that standard input is used as the standard 
input for command on the remote machine. Standard 
input comes from the local host and not from the remote 
machine. 

-f file Use the specified file as the standard input for command 

on the remote machine. The file exists on the local host 
and not on the remote machine. 

-m Mails the user to report completion of the command. By 

default, mail reports only errors. 

-u user Any mail goes to the named user on machine. The default 
machine is the machine on which an error was detected, 
or on which the remote command was completed. The 
mail will be redirected to the appropriate mailbox(es), if 
an alias for user exists in the system alias files on that ma- 
chine . Since system alias files are usually identical 
throughout the network, any specified machine will most 
likely be overridden by the aliasing mechanism. To 
prevent aliasing, user must be escaped with at least two \ 
characters (at least four if given as a shell command). 
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Before remote can be successfully used, a network of systems must 
first be set up and the proper daemons initialized using netutil (ADM). 
Also, entries for the command to be executed using remote must be 
added to the I etc f default! micnet files on each remote machine. 

Example 



The following command executes an Is command on the directory 
/tmp of the machine machinel : 

remote machinel Is /tmp 

See Also 



rcp(C), mail(C), netutil(ADM), micnet(F) 

Notes 



The mail command uses the equivalent of remote to send mail 
between machines. 
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rm 

removes files or directories 

Syntax 

rm [ -fri ] file ... 

Description 



rm removes the entries for one or more files from a directory. If an 
entry was the last link to the file, the file is destroyed. Removal of a 
file requires write permission in its directory, but neither read nor 
write permission on the file itself. 

If the user does not have write permission on a specified file and the 
standard input is a terminal, the user is prompted for confirmation. 
The file’s name and permissions are printed and a line is read from the 
standard input. If that line begins with y, the file is deleted, otherwise 
the file remains. If the -f option is given or if the standard input is not 
a terminal, no messages are issued; files are simply removed. 

rm will not delete directories unless the -r option is used. 

Options 



The following options are recognized. 

-f When invoked with the -f option, rm does not prompt the user for 
confirmation for files on which the user does not have write per- 
mission. The files are simply removed. 

-r The -r (recursive) option causes rm to recursively delete the entire 
contents of the any directories specified, and the directories them- 
selves. Note that the rmdir(C) command is a safer way of remov- 
ing directories. 

-i The -i (interactive) option causes rm to ask whether to delete each 
file, and if the -r option is in effect, whether to examine each direc- 
tory. 

The special option can be used to delimit options. For example, 
a file named “-f” could not be removed by rm because the hyphen is 
interpreted as an option; the command rm -f would do nothing, since 
no file is specified. Using rm - -f removes the file successfully. 
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See Also 



RM (C) 



rmdir(C) 

Notes 



It is forbidden to remove the file •. to avoid the consequences of inad- 
vertently doing something like: 

rm -r .* 

It is also forbidden to remove the root directory of a given file system. 

No more than 17 levels of subdirectories can be removed using the -r 
option. 

Standards Conformance 



rm is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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rmdir 

removes directories 

Syntax 

rmdir [-p] [-s] dimame ... 

Description 



rmdir removes the entries for one or more subdirectories from a direc- 
tory. A directory must be empty before it can be removed. Note that 
the “rm -r dir'' (command is a more dangerous alternative to rmdir.) 
If the parent directory has the sticky bit set, removal occurs only if one 
of the following is true: 

the parent directory is owned by the user 
the dirname directory is owned by the user 
the dirname directory is writable to the user 
the user is the super-user 

The -p option allows users to remove the directory dirname and its 
parent directories which become empty. A message is printed on stan- 
dard output as to whether the whole path is removed or part of the path 
remains for some reason. 

The -s option is used to suppress the message printed on standard error 
when -p is in effect. 

rmdir will refuse to remove the root directory of a mounted filesys- 
tem. 

See Also 



rm(C) 

Diagnostics 



rmdir returns an exit code of 0 if all the specified directories are 
removed successfully. Otherwise, it returns a non-zero exit code. 

Standards Conformance 



rmdir is conformant with: 

AT&TSVID Issue 2, Select Code 307-127. 



March 15, 1989 



RMDIR-1 









RSH (C) 



RSH (C) 



rsh 

invokes a restricted shell (command interpreter) 

Syntax 

rsh [ flags ] [ name [ argl ... ] ] 

Description 



rsh is a restricted version of the standard command interpreter sh(C). 
It is used to set up login names and execution environments whose 
capabilities are more controlled than those of the standard shell. The 
actions of rsh are identical to those of sh, except that changing direc- 
tory with cd, setting the value of $PATH, using command names con- 
taining slashes, and redirecting output using > and » are all disal- 
lowed. 

When invoked with the name -rsh, rsh reads the user’s .profile (from 
$HOME/.profile). It acts as the standard sh while doing this, except 
that an interrupt causes an immediate exit, instead of causing a return 
to command level. The restrictions above are enforced after .profile 
is interpreted. 

When a command to be executed is found to be a shell procedure, rsh 
invokes sh to execute it. Thus, it is possible to provide to the end user 
shell procedures that have access to the full power of the standard 
shell, while restricting him to a limited menu of commands; this 
scheme assumes that the end user does not have write and execute per- 
missions in the same directory. 

The net effect of these rules is that the writer of the .profile has com- 
plete control over user actions, by performing guaranteed setup 
actions, then leaving the user in an appropriate directory (probably not 
the login directory). 

rsh is actually just a link to sh and any flags arguments are the same 
as for sh{C). 

The system administrator often sets up a directory of commands that 
can be safely invoked by rsh. 

See Also 



sh(C), profile(M) 
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sddate 

prints and sets backup dates 

Syntax 



sddate [ name lev date ] 

Description 



If no argument is given, the contents of the backup date file /etc/ddate 
are printed. The backup date file is maintained by backup iC) and 
contains the date of the most recent backup for each backup level for 
each filesystem. 

If arguments are given, an entry is replaced or made in /etc/ddate. 
name is the last component of the device pathname, lev is the backup 
level number (from 0 to 9), and date is a time in the form taken by 
dateiCy. 

mmddhhmm[yy] 

Where the first mm is a two-digit month in the range 01-12, dd is a 
two-digit day of the month, hh is a two-digit military hour from 00-23, 
and the final mm is a two-digit minute from 00-59. An optional two- 
digit year, yy, is presumed to be an offset from the year 1900, i.e., 
19yy. 

Some sites may wish to back up file systems by copying them verba- 
tim to backup media, sddate could be used to make a “level 0“ entry 
in /etc/ddate, which would then allow incremental backups. 

For example: 

sddate rhda 5 10081520 

makes an /etc/ddate entry showing a level 5 backup of /dev/rhda on 
October 8, at 3:20 PM. 

Files 



/etc/ddate 
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See Also 



SDDATE (C) 



backup(C), dump(C), date(C) 

Diagnostics 

bad conversion If the date set is syntactically incorrect. 
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sdiff 

compares files side-by-side 

Syntax 

sdiff [ options ... ] filel file2 

Description 

sdiff uses the output of diff(C) to produce a side-by-side listing of two 
files indicating those lines that are different. Each line of the two files 
is printed with a blank gutter between them if the lines are identical, a 
< in the gutter if the line only exists in filel , a > in the gutter if the 
line only exists in file! , and a | for lines that are different. 

For example: 

X I y 

a a 

b < 

c < 

d d 

> c 

The following options exist: 

-w n Uses the next argument, n, as the width of the output 

line. The default line length is 130 characters. 

-1 Only prints the left side of any lines that are identical. 

-s Does not print identical lines. 

-o output Uses the next argument, output, as the name of a third 
file that is created as a user-controlled merging of filel 
and file2 . Identical lines of filel and filel are copied to 
output. Sets of differences, as produced by diffiC), are 
printed; where a set of differences share a common 
gutter character. After printing each set of differences, 
prompts the user with a % and waits for one of the 
following user-typed commands: 

1 Appends the left column to the output file 

r Appends the right column to the output file 
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s Turns on silent mode; does not print identi- 
cal lines 

V Turns off silent mode 
e 1 

Calls the editor with the left column 
e r 

Calls the editor with the right column 
e b 

Calls the editor with the concatenation of 
left and right 

e Calls the editor with a zero length file 
q Exits from the program 

On exit from the editor, the resulting file is concatenated 
on the end of the output file. 

See Also 



diffi;c), ed(C) 
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sed 

invokes the stream editor 

Syntax 



sed [ -n ] [ -e script ] [ -f sflle ] [ files ] 

Description 



sed copies the named files (standard input default) to the standard out- 
put, edited according to a script of commands. The -f option causes 
the script to be taken from file sfile; these options accumulate. If 
there is just one -e option and no -f options, the flag -e may be omit- 
ted. The -n option suppresses the default output. A script consists of 
editing commands, one per line, of the following form: 

[ address [ , address ] ] function [ arguments ] 

In normal operation, sed cyclically copies a line of input into a pattern 
space (unless there is something left after a D command), applies in 
sequence all commands whose addresses select that pattern space, 
and at the end of the script copies the pattern space to the standard 
output (except under -n) and deletes the pattern space. 

A semicolon (;) can be used as a command delimiter. 

Some of the commands use a hold space to save all or part of the pat- 
tern space for subsequent retrieval. 

An address is either a decimal number that counts input lines cumula- 
tively across files, a $ that addresses the last line of input, or a context 
address, i.e., a ! regular expression! in the style of ed{Q) modified as 
follows: 

- In a context address, the construction \? regular expression?, where 
? is any character, is identical to (regular expression!. Note that 
in the context address \xabc\xdefx, the second x stands for itself, 
so that the regular expression is abcxdef. 

- The escape sequence \n matches a newline embedded in the pat- 
tern space. 

- A period . matches any character except the terminal newline of 
the pattern space. 
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- A command line with no addresses selects every pattern space. 

- A command line with one address selects each pattern space that 
matches the address. 

- A command line with two addresses selects the inclusive range 
from the first pattern space that matches the first address through 
the next pattern space that matches the second. (If the second 
address is a number less than or equal to the line number first 
selected, only one line is selected.) Thereafter, the process is 
repeated, looking again for the first address. 

Editing commands can be applied only to nonselected pattern spaces 
by use of the negation function ! (below). 

In the following list of functions, the maximum number of permissible 
addresses for each function is indicated in parentheses. 

The text argument consists of one or more lines, all but the last of 
which end with backslashes to hide the newlines. Backslashes in text 
are treated like backslashes in the replacement string of an s com- 
mand, and may be used to protect initial blanks and tabs against the 
stripping that is done on every script line. The rfile or wjile argument 
must terminate the command line and must be preceded by exactly 
one blank. Each wjile is created before processing begins. There can 
be at most 10 distinct wjile arguments. 

(1) a\ 

text Appends text, placing it on the output before reading the 

next input line. 

(2) b label Branches to the : command bearing the label. If label is 

empty, branches to the end of the script. 

(2)c\ 

text Changes text by deleting the pattern space and then 

appending text. With 0 or 1 address or at the end of a 2- 
address range, places text on the output and starts the next 
cycle. 

(2) d Deletes the pattern space and starts the next cycle. 

(2)D Deletes the initial segment of the pattern space through 

the first newline and starts the next cycle. 

(2) g Replaces the contents of the pattern space with the con- 

tents of the hold space. 

(2)G Appends the contents of the hold space to the pattern 
space. 
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(2) h Replaces the contents of the hold space with the contents 
of the pattern space. 

(2)H Appends the contents of the pattern space to the hold 
space. 

(1) i\ 

text Insert. Places text on the standard output. 

(2) 1 Lists the pattern space on the standard output with non- 

printing characters spelled in two-digit ASCII and long 
lines folded. 

(2) n Copies the pattern space to the standard output. Replaces 
the pattern space with the next line of input. 

(2)N Appends the next line of input to the pattern space with an 
embedded newline. (The current line number changes.) 

(2) p Prints (copies) the pattern space on the standard output. 

(2)P Prints (copies) the initial segment of the pattern space 
through the first newline to the standard output. 

(1) q Quits sed by branching to the end of the script. No new 

cycle is started. 

(2) r r/ite Reads the contents of rfile and places them on the output 

before reading the next input line. 

(2)slregular expression! replacementiflags 

Substitutes the replacement string for instances of the 
regular expression in the pattern space. Any character 
may be us^ instead of /. For a more detailed description, 
see ed{C). Flags is zero or more of: 

n n=l-512. Substitute for just the nth occurrence of the 
regular expression, 

g Globally substitutes for all nonoverlapping instances 
of the regular expression rather than just the first one. 

p Prints the pattern space if a replacement was made. 

wwfile 

Writes the pattern space to wfile if a replacement was 
made. 

(2)i label Branches to the colon (:) command bearing label if any 
substitutions have been made since the most recent read- 
ing of an input line or execution of a t command. If label 
is empty, t branches to the end of the script. 
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(2) w wfile Writes the pattern space to wfile . 

(2) X Exchanges the contents of the pattern and hold spaces. 

(2) ylstringl I string! / 

Replaces all occurrences of characters in stringl with the 
corresponding characters in stringl . The lengths of 
stringl and stringl must be equal. 

(2)! function 

Applies the function (or group, if function is { ) only to 
lines not selected by the address(es). 

(0) : label This command does nothing; it bears a label for b and t 

commands to branch to. 

(1) = Places the current line number on the standard output as a 

line. 

(2) { Executes the following commands through a matching } 

only when the pattern space is selected. 

(0) An empty command is ignored. 

See Also 



awk(C), ed(C), grep(C) 

Notes 



This command is explained in detail in the User's Guide. 

Standards Conformance 



sed is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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setcolor, setcolour 

set screen color and other screen attributes 
Syntax 

setcolor -[nbrgopc] argument [argument] 

Description 



setcolor allows the user to set the screen color on a color screen. Both 
foreground and background colors can be set independently in a range 
of 16 colors, setcolor can also set the reverse video and graphics 
character colors, setcolor with no arguments produces a usage mes- 
sage that displays all available colors, then resets the screen to its pre- 
vious state. 

For example, the following strings are possible colors. 

blue magenta brown black 

lt_blue lt_magenta yellow gray 

cyan white green red 

lt_cyan hi_white lt_green lt_red 

The following flags are available. In the arguments below, “color” is 
taken from the above list. 



-n Set the screen to “normal” white characters on black background. 
color [color] 

Set the foreground to the first color. Sets background to second 
color if a second color choice is specified. 

-b color 

Set the background to the specified color. 

-r color color 

Set the foreground reverse video characters to the first color. Set 
reverse video characters’ background to second color. 

-g color color 

Set the foreground graphics characters to the first color. Set graph- 
ics characters’ background to second color. 

-o Set the color of the screen border (overscan region). 
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-p pitch duration 

Set the pitch and duration of the bell. Pitch is the period in 
microseconds, and duration is measured in fifths of a second. 
When using this option, a control-G (bell) must be echoed to the 
screen for the command to work. For example: 

setcolor *p 2500 2 
echo "G 

-c first last 

Set the first and last scan lines of the cursor. (For more informa- 
tion see screen(HW).) 

Notes 



The ability of setcolor to set any of these described functions is ulti- 
mately dependent on the ability of devices to support them, setcolor 
emits an escape sequence that may or may not have an effect on mono- 
chrome devices. 

Occasionally changing the screen color can help prolong the life of 
your monitor. 

See Also 



screen(HW) 

Value Added 



setcolor and setcolour sre extensions of AT&T System V provided by 
Altos UNIX System V. 
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setkey 

assigns the function keys 

Syntax 

setkey keynum string 

Description 



The setkey command assigns the given ANSI string to be the output 
of the computer function key given by keynum. For example, the 
command: 

setkey 1 date 

assigns the string "date” as the output of function key 1. The string 
can contain control characters, such as a newline character, and 
should be quoted to protect it from processing by the shell. For exam- 
ple, the command: 

setkey 2 "pwd ; lc\n” 

assigns the command sequence ”pwd ; Ic" to function key 2. Notice 
how the newline character is embedded in the quoted string. This 
causes the commands to be carried out when function key 2 is pressed. 
Otherwise, the Enter key would have to be pressed after pressing the 
function key, as in the previous example. 

setkey translates " into which, when passed to the screen driver, is 
interpreted as a right angle bracket (>), or greater than key. 

Notes 



setkey works only on the console keyboard. 

The string mapping table is where the function keys are defined. It is 
an array of 512 bytes (typedef strmapj ) where null terminated strings 
can be put to redefine the function keys. The first null terminated 
string is assigned to the first string key, the second to the second string 
key, and so on. There is one string mapping table per multiscreen. 

Although the size of the setkey string mapping table is 512 bytes, 
there is a limit of 30 characters that can be assigned to any individual 
function key. 
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Assigning more than 512 characters to the string mapping table causes 
the function key buffer to overflow. When this happens, the sequences 
sent by the arrow keys are overwritten, effectively disabling them. 
Once the function key buffer overflows, the only way to enable the 
arrow keys is to reboot the system. 

The table below lists the keymm vdlvL&s for the function keys: 



Function key 


keynum 


Function key 


keynum 


FI 


1 


Ctrl-FlO 


34 


F2 


2 


Ctrl-Fl 1 


35 


F3 


3 


Ctrl-F12 


36 


F4 


4 


Ctrl-Shift-Fl 


37 


F5 


5 


Ctrl-Shift-F2 


38 


F6 


6 


Ctrl-Shift-F3 


39 


F7 


7 


Ctrl-Shift-F4 


40 


F8 


8 


Ctrl-Shift-F5 


41 


F9 


9 


Ctrl-Shift-F6 


42 


FIO 


10 


Ctrl-Shift-F7 


43 


Fll 


11 


Ctrl-Shift-F8 


44 


F12 


12 


Ctrl-Shift-F9 


45 


Shift-Fl 


13 


Ctrl-Shift-FlO 


46 


Shift-F2 


14 


Ctrl-Shift-Fll 


47 


Shift-F3 

Shift-F4 


15 

16 


Ctrl-Shift-F12 


48 






Shift-F5 

Shift-F6 


17 

18 


Numeric Key-Pad 


keynum 






Shift-F7 


19 


7 


49 


Shift-F8 


20 


8 


50 


Shift-F9 


21 


9 


51 


Shift-FlO 


22 


- 


52 


Shift-Fl 1 


23 


4 


53 


Shift-F12 


24 


5 


54 


Ctrl-Fl 


25 


6 


55 


Ctrl-F2 


26 


+ 


56 


Ctrl-F3 


27 


1 


57 


Ctrl-F4 


28 


2 


58 


Ctrl-F5 


29 


3 


59 


Ctrl-F6 


30 


0 


60 


Ctrl-F7 


31 






Ctrl-F8 


32 






Ctrl-F9 


33 







For a table of the escape sequences, refer to keyboard(HW). 
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Files 

/bin/setkey 

See Also 

keyboard(HW) 
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setmode 

Port modes utility 

Syntax 



setmode device mode ... 

Description 



The setmode utility sets tty modes (see tty(M)) for tty ports that are 
being used for serial devices. (Use this utility to set baud rate, tab 
expansion, and newline actions for programs that communicate 
directly through a serial port.) 

This utility takes a list of tty modes from its command line, performs 
stty(C) on the indicated device, and sleeps forever, which keeps device 
open with the desired modes. Invoke setmode once for each port de- 
vice. 

To ensure that setmode is run every time the system enters multiuser 
mode, invoke setmode in the /etc/inittab file. 

You must invoke setmode with at least two arguments: the name of the 
device special file (for example, /dev/ttyOl), and at least one tty mode. 

Files 



/dev/tty* tty devices 
/etc/inittab 

Related Commands 



disable(C), enable(C), stty(C), inittab(F), pcu(ADM), 

See Also 



tty(M) 

Value Added 



setmode is an extension of AT&T System V provided by Altos UNDC 
System V. 
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sh 

invokes the shell command interpreter 

Syntax 



sh [ -aceiknrstuvx ] [ args ] 

Description 



The shell is the standard command programming language that exe- 
cutes commands read from a terminal or a file. See Invocation below 
for the meaning of arguments to the shell. 



Commands 

A simple-command is a sequence of nonblank words separated by 
blanks (a blank is a tab or a space). The first word sj^cifies the name 
of the command to be executed. Except as specified below, the 
remaining words are passed as arguments to the invoked command. 
The command name is passed as argument 0 (see exec(S)), The value 
of a simple-command is its exit status if it terminates normally, or 
(octal) lOOO^status if it terminates abnormally (i.e., if the failure pro- 
duces a core file). See signal (S) for a list of status values. 

A pipeline is a sequence of one or more commands separated by a 
vertical bar ( I ). (The caret ( '^ ), is an obsolete synonym for the verti- 
cal bar and should not be used in a pipeline.) The standard output of 
each command but the last is connected by a pipeiS) to the standard 
input of the next command. Each command is run as a separate pro- 
cess; the shell waits for the last command to terminate. 

A list is a sequence of one or more pipelines separated by &, &&, 
or 1 1 , and optionally terminated by ; or & . Of these four symbols, ; 
and & have equal precedence, which is lower than that of && and 1 1 . 
The symbols && and 1 1 also have equal precedence. A semicolon (;) 
causes sequential execution of the preceding pipeline; an ampersand 
(&) causes asynchronous execution of the preceding pipeline (i.e., the 
shell does not wait for that pipeline to finish). The symbol && ( 1 1 ) 
causes the list following it to be executed only if the preceding pipe- 
line returns a zero (nonzero) exit status. An arbitrary number of new- 
lines may appear in a list, instead of semicolons, to delimit com- 
mands. 
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A command is either a simple-command or one of the following com- 
mands. Unless otherwise stated, the value returned by a command is 
that of the last simple-command executed in the command: 

for name [ in word ... ] 

do 

list 

done 

Each time a for command is executed, name is set to the next word 
taken from the in word list. If in word is omitted, then the for com- 
mand executes the do list once for each positional parameter that is 
set (see Parameter Substitution below). Execution ends when there 
are no more words in the list. 

case word in 

[ pattern [ I pattern ] ...) list 

;; ] 

esac 

A case command executes the list associated with the first pat- 
tern that matches word. The form of the patterns is the same as that 
used for filename generation (see Filename Generation below). 

if list then 
list 

[ elif list then 
list ] 

[ else list ] 
fi 

The list following if is executed and, if it returns a zero exit status, the 
list following the first then is executed. Otherwise, the list following 
elif is executed and, if its value is zero, the list following the next 
then is executed. Failing that, the else list is executed. If no else list 
or then list is executed, then the if command returns a zero exit status. 

while list 
do 

list 

done 

A while command repeatedly executes the while list and, if the exit 
status of the last command in the list is zero, executes the do list\ oth- 
erwise the loop terminates. If no commands in the do list are exe- 
cuted, then the while command returns a zero exit status; until may be 
used in place of while to negate the loop termination test. 

{list) 

Executes list in a subshell. 

{list;} 

list is simply executed. 
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name () {list;} 

Define a function which is referenced by name. The body of func- 
tions is the list of commands between { and }. Execution of func- 
tions is described later (see Execution.) 



The following words are recognized only as the first word of a com- 
mand and when not quoted: 

if then else elif fi case esac for while until do done { } 



Comments 

A word beginning with # causes that word and all the following char- 
acters up to a newline to be ignored. 



Command Substitution 

The standard output from a command enclosed in a pair of grave 
accents ^ ) may be used as part or all of a word; trailing newlines 
are removed. 

No interpretation is done on the command string before the string is 
read, except to remove backslashes (\) used to escape other characters. 
Backslashes may be used to escape grave accents (') or other 
backslashes and are removed before the command string is read. 
Escaping grave accents allows nested command substitution. If the 
command substitution lies withing a pair of double quotes (" ‘ ... ‘ "), 
backslashes used to escape a double quote (\”) will be removed; other- 
wise, they will be left intact. 

If a backslash is used to escape a newline character, both the 
backslash and the newline are removed (see the section on “Quot- 
ing”). In addition, backslashes used to escape dollar signs (\$) are 
removed. Since no interpretation is done on the command string 
before it is read, inserting a backslash to escape a dollar sign has not 
effect. Backslashes that precede characters other than \, ", newline, 
and $ are left intact. 



Parameter Substitution 

The character $ is used to introduce substitutable parameters. There 
are two types of parameters, positional and keyword. If parameter is a 
digit, it is a positional parameter. Positional parameters may be 
assigned values by set. Keyword parameters, (dso known as vari- 
ables) may be assigned values by writing: 



March 15, 1989 



SH-3 




SH(C) 



SH (C) 



name rvalue [ name rvalue ] ... 

Pattern “matching is not performed on value. There cannot be a func- 
tion and a variable with the same name. 

^{parameter} 

A parameter is a sequence of letters, digits, or underscores (a 
name), a digit, or any of the characters *, @, #, ?, -, $, and !. The 
value, if any, of the parameter is substituted. The braces are 
required only when parameter is followed by a letter, digit, or 
underscore that is not to be interpreted as part of its name. A name 
must begin with a letter or underscore. If parameter is a digit then 
it is a positional parameter. If parameter is * or @, then all the 
positional parameters, starting with $1, are substituted (separated 
by spaces). Parameter $0 is set from argument zero when the shell 
is invoked. 

^{parameter : -word} 

If parameter is set and is not a null argument, substitute its value; 
otherwise substitute word. 

${parameter : =word} 

If parameter is not set or is null, then set it to word\ the value of 
the parameter is then substituted. Positional parameters may not 
be assigned to in this way. 

^{parameter : Iword} 

If parameter is set and is not a null argument, substitute its value; 
otherwise, print word and exit from the shell. If word is omitted, 
the message “parameter null or not set” is printed. 

${parameter : +word] 

If parameter is set and is not a null argument, substitute word; oth- 
erwise substitute nothing. In the above, word is not evaluated 
unless it is to be used as the substituted string, so that in the fol- 
lowing example, pwd is executed only if d is not set or is null: 

echo ${d:-^pwd^ } 

If the colon (:) is omitted from the above expressions, then the shell 
only checks whether parameter is set. 

The following parameters are automatically set by the shell: 

# The number of positional parameters in decimal 

- Flags supplied to the shell on invocation or by the set command 

? The decimal value returned by the last synchronously executed 
command 
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$ The process number of this shell 

! The process number of the last background command invoked 
The following parameters are used by the shell: 

CDPATH 

Defines search path for the cd command. See the section Special 
Commands^ “cd”. 

HOME 

The default argument (home directory) for the cd command 
PATH 

The search path for commands (see Execution below) 

MAIL 

If this variable is set to the name of a mail file, then the shell 
informs the user of the arrival of mail in the specified file 

MAILCHECK 

This parameter specifies how often (in seconds) the shell will 
check for the arrival of mail in the files specified by the 
MAILPATH or MAIL parameters. The default value is 600 
seconds (10 minutes). If set to 0, the shell will check before each 
prompt. 

MAILPATH 

A colon (:) separated list of file names. If this parameter is set, the 
shell informs the user of the arrival of mail in any of the specified 
files. Each file name can be followed by % and a message that 
will be printed when the modification time changes. The default 
message is you have mail. 

PSl 

Primary prompt string, by default “$ ” 

PS2 

Secondary prompt string, by default “> ” 

IFS 

Internal field separators, normally space, tab, and newline 
SHACCT 

If this parameter is set to the name of a file writable by the user, 
the shell will write an accounting record in the file for each shell 
procedure executed. Accounting routines such as acctcom{hDM) 
and accton{kT>M) can be used to analyze the data collected. This 
feature does not work with all versions of the shell. 
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SHELL 

When the shell is invoked, it scans the environment (see Environ- 
ment below) for this name. If it is found and there is an ‘r’ in the 
file name part of its value, the shell becomes a restricted shell. 

The shell gives default values to PATH, PSl, PS2, and IFS, while 
HOME and MAIL are not set at all by the shell (although HOME is set 
by loginQA)). 



Blank Interpretation 

After parameter and command substitution, the results of substitution 
are scanned for internal field separator characters (those found in IFS) 
and split into distinct arguments where such characters are found. Ex- 
plicit null arguments (** ** or ^ ^) are retained. Implicit null arguments 
(those resulting from parameters that have no values) are removed. 



Filename Generation 

Following substitution, each command word is scanned for the char- 
acters *, ?, and [. If one of these characters appears, the word is 
regarded as a pattern . The word is replaced with alphabetically sorted 
filenames that match the pattern. If no filename is found that matches 
the pattern, the word is left unchanged. The character . at the start of a 
filename or immediately following a /, as well as the character / itself, 
must be matched explicitly. These characters and their matching pat- 
terns are: 

* Matches any string, including the null string. 

? Matches any single character. 

[...] 

Matches any one of the enclosed characters. A pair of characters 
separated by - matches any character lexically between the pair, 
inclusive. If the first character following the opening bracket ([) is 
an exclamation mark (!), then any character not enclosed is 
matched. 



Quoting 

The following characters have a special meaning to the shell and 
cause termination of a word unless quoted: 

;&()!"<> newline space tab 

A character may be quoted (i.e., made to stand for itself) by preceding 
it with a \. The pair \newline is ignored. All characters enclosed 
between a pair of single quotation marks except a single 
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quotation mark, are quoted. Inside double quotation marks (****), 
parameter and command substitution occurs and \ quotes the charac- 
ters \, ”, and $. ”$*” is equivalent to ”$1 $2 . . whereas 

is equivalent to ”$1” ”$2” . . . 



Prompting 

When used interactively, the shell prompts with the value of PSl 
before reading a command. If at any time a newline is typed and 
further input is needed to complete a command, the secondary prompt 
(i.e., the value of PS2) is issued. 

Spelling Checker 

When using cd{C) the shell checks spelling. For example, if you 
change to a different directory using cd and misspell the directory 
name, the shell responds with an alternative spelling of an existing 
directory. Enter “y” and press RETURN (or just press RETURN) to 
change to the offered directory. If the offered spelling is incorrect, 
enter “n”, then retype the command line. In this example the sh(C) 
response is boldfaced: 

$ cd /usr/spol/uucp 
cd /usr/spool/uucp?y 



InputlOutput 

Before a command is executed, its input and output may be redirected 
using a special notation interpreted by the shell. The following may 
appear anywhere in a simple -command or may precede or follow a 
command. They are not passed on to the invoked command; substitu- 
tion occurs before word or digit is used: 

<word Use file word as standard input (file descriptor 0). 

>word Use file word as standard output (file descriptor 1). 

If the file does not exist, it is created; otherwise, it is 
truncated to zero length. 

>word Use file word as standard output. If the file exists, 

output is appended to it (by first seeking the 
end-of-file); otherwise, the file is created. 

<[ - ]word The shell input is read up to a line that is the same as 
wordy or to an end-of-file. The resulting document 
becomes the standard input. If any character of word 
is quoted, no interpretation is placed upon the char- 
acters of the document; otherwise, parameter and 
command substitution occurs, (unescaped) \newline 
is ignored, and \ must be used to quote the characters 
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and the first character of word. If - is 
appended to (S)all leading tabs are stripped from 
word and from the document. 

<Scdigit The standard input is duplicated from file descriptor 

digit (see dup(S)). Similarly for the standard output 
using >. 

<&- The standard input is closed. Similarly for the stan- 

dard output using >. 

If one of the above is preceded by a digit, the file descriptor created is 
that specified by the digit (instead of the default 0 or 1). For example: 

... 2>&1 

creates file descriptor 2 that is a duplicate of file descriptor 1 . 

If a command is followed by &, the default standard input for the 
command is the empty file /dev/null. Otherwise, the environment for 
the execution of a command contains the file descriptors of the invok- 
ing shell as modified by input/output specifications. 



Environment 

The environment (see environ (M)) is a list of name-value pairs that is 
passed to an executed program in the same way as a normal argument 
list. The shell interacts with the environment in several ways. On 
invocation, the shell scans the environment and creates a parameter 
for each name found, giving it the corresponding value. Executed 
commands inherit the same environment. If the user modifies the 
values of these parameters or creates new ones, none of these affect 
the environment unless the export command is used to bind the shell’s 
parameter to the environment. The environment seen by any executed 
command is composed of any unmodified name-value pairs originally 
inherited by the shell, minus any pairs removed by unset, plus any 
modifications or additions, all of which must be noted in export com- 
mands. 

The environment for any simple -command may be augmented by 
prefixing it with one or more assignments to parameters. Thus: 

TERM=450 cmd args 
and 



(export TERM; TERM=450; cmd args) 
are equivalent (as far as the above execution of cmd is concerned). 
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If the -k flag is set, all keyword arguments are placed in the environ- 
ment, even if they occur after the command name. 



Signals 

The INTERRUPT and QUIT signals for an invoked command are 
ignored if the command is followed by &; otherwise signals have the 
values inherited by the shell from its parent, with the exception of sig- 
nal 1 1 . See the trap command below. 

Execution 

Each time a command is executed, the above substitutions are carried 
out. If the command name does not match a Special Command, but 
matches the name of a defined function, the function is executed in the 
shell process (note how this differs from the execution of shell pro- 
cedures). The positional parameters $1, $2, ... are set to the arguments 
of the function. If the command name matches neither a Special Com- 
mand nor the name of a defined function, a new process is created and 
an attempt is made to execute the command via exec(S), 

The shell parameter PATH defines the search path for the directory 
containing the command. Alternative directory names are separated 
by a colon (:). The default path is :/bin:/usr/bin (specifying the 
current directory, /bin, and /usr/bin, in that order). Note that the 
current directory is specified by a null pathname, which can appear 
immediately after the equal sign or between the colon delimiters any- 
where else in the path list. If the command name contains a /, then the 
search path is not used. Otherwise, each directory in the path is 
searched for an executable file. If the file has execute permission but 
is not an a.out file, it is assumed to be a file containing shell com- 
mands. A subshell (i.e., a separate process) is spawned to read it. A 
parenthesized command is also executed in a subshell. 

Shell procedures are often used by users running the csh. However, if 
the first character of the procedure is a # (comment character), csh 
assumes the procedure is a csh script, and invokes Ibinlcsh to execute 
it. Always start sh procedures with some other character if csh users 
are to run the procedure at any time. This invokes the standard shell 
Ibinish . 

The location in the search path where a command was found is 
remembered by the shell (to help avoid unnecessary execs later). If 
the command was found in a relative directory, its location must be 
re-determined whenever the current directory changes. The shell for- 
gets all remembered locations whenever the PATH variable is changed 
or the hash -r command is executed (see hash in next section). 
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Special Commands 

Input/output redirection is permitted for these commands: 

: No effect; the command does nothing. A zero exit code is 

returned. 

.file 

Reads and executes commands from file and returns. The search 
path specified by PATH is used to find the directory containing file. 

break [ n ] 

Exits from the enclosing for or while loop, if any. If n is specified, 
it breaks n levels. 

continue [ n ] 

Resumes the next iteration of the enclosing for or while loop. If n 
is specified, it resumes at the «-th enclosing loop. 

cd [ arg ] 

Changes the current directory to arg. The shell parameter HOME 
is the default arg. The shell parameter CDPATH defines the 
search path for the directory containing arg. Alternative directory 
names are separated by a colon (:). The default path is <null> 
(specifying the current directory). Note that the current directory 
is specified by a null path name, which can appear immediately 
after the equal sign or between the colon delimiters anywhere else 
in the path list. If arg begins with a /, the search path is not used. 
Otherwise, each directory in the path is searched for arg. 

If the shell is reading its commands from a terminal, and the specified 
directory does not exist (or some component cannot be searched), 
spelling correction is applied to each component of directory, in a 
search for the “correct” name. The shell then asks whether or not to 
try and change directory to the corrected directory name; an answer of 
n means “no”, and anything else is taken as “yes”. 

echo [ arg ] 

Writes arguments separated by blanks and terminated by a newline 
on the standard output. Arguments may be enclosed in quotes. 
Quotes are required so that the shell correctly interprets these spe- 
cial escape sequences: 

\b Backspace 

\c Prints line without newline. 

\f Formfeed 
\n Newline 
\r Carriage return 



March 15, 1989 



SH-10 




SH (C) 



SH (C) 



\t Tab 

\v Vertical tab 
W Backslash 

\n The 8-bit character whose ASCII code is the 1,2 or 3-digit octal 
number n must start with a zero 

eval [ arg . . . ] 

The arguments are read as input to the shell and the resulting 
command(s) executed. 

exec [ arg . . . ] 

The command specified by the arguments is executed in place of 
this shell without creating a new process. Input/output arguments 
may appear and, if no other arguments are given, cause the shell 
input/output to be modified. 

exit [ n ] 

Causes a shell to exit with the exit status specified by n. If « is 
omitted, the exit status is that of the last command executed. An 
end-of-file will also cause the shell to exit. 

export [ name . . . ] 

The given names are marked for automatic export to the environ- 
ment of subsequently executed commands. If no arguments are 
given, a list of all names that are exported in this shell is printed. 

getopts 

Use in shell scripts to support command syntax standards (see 
intro (C)); it parses positional parameters and checks for legal 
options. See getopts (C) for usage and description. 

hash [ -r ] [ name . . . ] 

For each name, the location in the search path of the command 
specified by name is determined and remembered by the shell. The 
-r option causes the shell to forget all remembered locations. If no 
arguments are given, information about remembered commands is 
presented. Hits is the number of times a command has been 
invoked by the shell process. Cost is a measure of the work 
required to locate a command in the search path. There are certain 
situations which require that the stored location of a command be 
recalculated. Commands for which this will be done are indicated 
by an asterisk (*) adjacent to the hits information. Cost will be 
incremented when the recalculation is done. 

newgrp [arg ... ] 

^uivalent to exec newgrp arg . . . 

pwd 

Print the current working directory. See pwd(C) for usage and 
description. 

read [ name . . . ] 

One line is read from the standard input and the first word is 
assigned to the first name, the second word to the second name, 
etc., with leftover words assigned to the last name. The return 
code is 0 unless an end-of-file is encountered. 
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readonly [ name . . . ] 

The given names are marked readonly and the values of the these 
names may not be changed by subsequent assignment. If no argu- 
ments are given, a list of all readonly names is printed. 

return [ n ] 

Causes a function to exit with the return value specified by n. If n 
is omitted, the return status is that of the last command executed. 

set [ -eknuvx [ arg . . . ] ] 

-a Mark variables which are modified or created for export. 

-e If the shell is noninteractive, exits immediately if a command 
exits with a nonzero exit status. 

-f Disables file name generation. 

-h Locates and remembers function commands as functions are 
defined (function commands are normally located when the 
function is executed). 

-k Places all keyword arguments in the environment for a com- 
mand, not just those that precede the command name. 

-n Reads commands but does not execute them. 

-u Treats unset variables as an error when substituting. 

-V Prints shell input lines as they are read. 

-X Prints commands and their arguments as they are executed. 
Although this flag is passed to subshells, it does not enable trac- 
ing in those subshells. 

- Does not change any of the flags; useful in setting $1 to -. 

Using + rather than - causes these flags to be turned off. These 
flags can also be used upon invocation of the shell. The current set 
of flags may be found in $-. The remaining arguments are posi- 
tional parameters and are assigned, in order, to $1, $2, ... If no 
arguments are given, the values of all names are printed. 

shift 

The positional parameters from $2 . . . are renamed $1 . . . 
test 

Evaluates conditional expressions. See testiC) for usage and 
description. 

times 

Prints the accumulated user and system times for processes run 
from the shell. 

trap [ arg ][ n ] ... 

arg is a command to be read and executed when the shell receives 
signal(s) n. (Note that arg is scanned once when the trap is set and 
once when the trap is taken.) Trap commands are executed in 
order of signal number. The highest signal number allowed is 16. 
Any attempt to set a trap on a signal that was ignored on entry to 
the current shell is ineffective. An attempt to trap on signal 11 
(memory fault) produces an error. If arg is absent, all trap(s) n are 
reset to their original values. If arg is the null string, this signal is 
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ignored by the shell and by the commands it invokes. If n is 0, the 
command arg is executed on exit from the shell. The trap com- 
mand with no arguments prints a list of commands associated with 
each signal number. 

type [ name . . . ] 

For each name, indicate how it would be interpreted if used as a 
command name. 

ulimit [ n ] 

imposes a size limit of n blocks on files written by the shall and its 
child processes (files of any size may be read). Any user may 
decrease the file size limit, but only the super-user (root) can 
increase the limit. With no argument, the current limit is printed. 

If no option is given and a number is specified, -f is assumed, 
unset [ name ... ] 

For each name, remove the corresponding variable or function. The 
variables PATH, PSl, PS2, MAILCHECK and IFS cannot be unset. 

umask [ ooo ] 

The user file-creation mask is set to the octal number ooo where o is 
an octal digit (see umask(C)). If ooo is omitted, the current value of 
the mask is printed. 

wait [ n ] 

Waits for the specified process to terminate, and reports the termina- 
tion status. If n is not given, all currently active child processes are 
waited for. The return code from this command is always 0. 

Invocation 

If the shell is invoked through exec{S) and the first character of argu- 
ment 0 is -, commands are initially read from /etc/profile and then 
from $HOME/.profile, if such files exist. Thereafter, commands are 
read as described below, which is also the case when the shell is 
invoked as /bin/sh. The flags below are interpreted by the shell on 
invocation only; note that unless the -c or -s flag is specified, the first 
argument is assumed to be the name of a file containing commands, 
and the remaining arguments are passed as positional parameters to 
that command file: 

-c string If the -c flag is present, commands are read from string . 

-s If the -s flag is present or if no arguments remain, com- 

mands are read from the standard input. Any remaining 
arguments specify the positional parameters. Shell output 
is written to file descriptor 2. 

-t If the -t flag is present, a single command is read and exe- 

cuted, and the shell exits. This flag is intended for use by 
C programs only and is not useful interactively. 

-i If the -i flag is present or if the shell input and output are 

attached to a terminal, this shell is interactive . In this 
case, TERMINATE is ignored (so that kill 0 does not kill 
an interactive shell) and INTERRUPT is caught and 
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ignored (so that wait is interruptible). In all cases, QUIT 
is ignored by the shell. 

-r If the -r flag is present, the shell is a restricted shell (see 

rsh(0). 

The remaining flags and arguments are described under the set com- 
mand above. 

Exit Status 



Errors detected by the shell, such as syntax errors, cause the shell to 
return a nonzero exit status. If the shell is being used noninterac- 
tively, execution of the shell file is abandoned. Otherwise, the shell 
returns the exit status of the last command executed. See the exit com- 
mand above. 

Files 



/etc/profile system default profile if none is present 

$HOME/.profile read by login shell at login 
/tmp/sh* temporary file for « 

/devMull source of empty file 

See Also 



cd(C), env(C), login(M), newgrp(C), rsh(C), test(C), umask(C), 
dup(S), exec(S), fork(S), pipe(S), signal(S), umask(S), wait(S), 
a.out(F), profile(M), environ(M) 

Notes 



The command readonly (without arguments) produces the same out- 
put as the command export. 

If « is used to provide standard input to an asynchronous process 
invoked by &, the shell gets mixed up about naming the input docu- 
ment; a garbage file /tmp/sh* is created and the shell complains about 
not being able to find that file by another name. 

If a command is executed, and a command with the same name is 
installed in a directory in the search path before the directory whe *e 
the original command was found, the shell will continue to exec the 
original command. Use the hash command to correct this situation. 

If you move the current directory or one above it, pwd may not give 
the correct response. Use the cd command with a full path name to 
correct this situation. 
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When a sh(C) user logs in, the system reads and executes commands 
in letc/profile before executing commands in the user’s 
$HOME/.profile. You can, therefore, modify the environment for all 
sh(C) users on the system by editing ! etc! profile. 

The shell doesn’t treat the high (eighth) bit in the characters of a com- 
mand line argument specially, nor does it strip the eighth bit from the 
characters of error messages. Previous versions of the shell used the 
eighth bit as a quoting mechanism. 

Existing programs that set the eighth bit of characters in order to quote 
them as part of the shell command line should be changed to use of the 
standard shell quoting mechanisms (see the section on “Quoting”). 

Words used to filenames in input/output redirection are not interpreted 
for filename generation (see the section on “File Name Generation”). 
For example, cat filel > a* will create a file named a***. 

Because commands in pipelines are run as separate processes, vari- 
ables set in a pipeline have no effect on the parent shell. 

If you get the error message: 

fork failed - too many processes 

try using the wait(C) command to clean up your background pro- 
cesses. If this doesn’t help, the system process table is probably full or 
you have too many active foreground processes (there is a limit to the 
number of processes that can associated with your login, and to the 
number the system can keep track of.). 

Warnings 



If a command is executed, and a command with the same name is 
installed in a directory in the search path before the directory where 
the original command was found, the shell will continue to exec the 
original command. Use the hash command to correct this situation. 

Not all processes of a 3- or more-stage pipeline are children of the 
shell, and thus cannot be waited for. 

For wait n, if n is not an active process id, all your shell’s currently 
active background processes are waited for and the return code will be 
zero. 

Standards Conformance 



sh is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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Shi 

shell layer manager 
Syntax 

shl 

Description 



shl allows a user to interact with more than one shell from a single ter- 
minal. The user controls these shells, known as layers , using the com- 
mands described below. 

The current layer is the layer that can receive input from the key- 
board. Other layers attempting to read from the keyboard are blocked. 
Output from multiple layers is multiplexed onto the terminal. To have 
the output of a layer blocked when it is not current, the stty(C) option 
loblk may be set within the layer. 

The stty character swtch (set to "Z if NUL) is used to switch control to 
shl from a layer, shl has its own prompt, >, to help distinguish it from 
a layer. 

A layer is a shell that has been bound to a virtual tty device 
(/dev/sxt???). The virtual device can be manipulated like a real tty 
device using stty{C) and ioctl(S). Each layer has its own process 
group id. 

Definitions 



A name is a sequence of characters delimited by a blank, tab or new- 
line. Only the first eight characters are significant. The names (1) 
through (7) cannot be used when creating a layer. They are used by 
shl when no name is supplied. They may be abbreviated to just the 
digit. 

Commands 



The following commands may be issued from the shl prompt level. 
Any unique prefix is accepted. 

create [ name ] 

Create a layer called name and make it the current layer. If no 
argument is given, a layer will be created with a name of the form 
(#) where # is the last digit of the virtual device bound to the layer. 



March 15, 1989 



SHL-1 








SHL(C) 



SHL(C) 



The shell prompt variable PSl is set to the name of the layer fol- 
lowed by a space, or, if superuser, the name followed by a sharp (#) 
and a space. A maximum of seven layers can be created. 

block name [ name ... ] 

For each name, block the output of the corresponding layer when it 
is not the current layer. This is equivalent to setting the stty option 
loblk within the layer. 

delete name [ name . . . ] 

For each name, delete the corresponding layer. All processes in 
the process group of the layer are sent the SIGHUP signal (see sig- 
n^/(2)). 

help (or ?) 

Print the syntax of the shl commands, 
layers [ -1 ] [ name . . . ] 

For each name, list the layer name and its process group. The -1 
option produces a p^(l)-like listing. If no arguments are given, in- 
formation is presented for all existing layers. 

resume [ name ] 

Make the layer referenced by name the current layer. If no argu- 
ment is given, the last existing current layer will be resumed. 

toggle 

Resume the layer that was current before the last current layer, 
unblock name [ name ... ] 

For each name, do not block the output of the corresponding layer 
when it is not the current layer. This is equivalent to setting the 
stty option loblk within the layer. 

quit 

Exit shl. All layers are sent the SIGHUP signal. 
name 

Make the layer referenced by name the current layer. 



Files 



/dev/sxt??? 

$SHELL 


Virtual tty devices 

Variable containing path name of the shell to 
use (default is /bin/sh). 


See Also 





ioctl(S), mkdev(ADM), sh(C), signal(S), stty(C), sxt(M) 
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It is inadvisable to kill shl. 

If shl does not run properly on a particular terminal, you may have to 
set istrip for that terminal’s line by entering the following command 
at the terminal: 

stty istrip 

By default, the Operating System is not configured for shell layers. To 
add this to kernel, use the command: 

mkdev shl 

This executes a script which prompts you for the number of sessions 
desired. The script dso allows you to relink the kernel. The new ses- 
sion limit becomes effective after the kernel is rebooted. (For rriore in- 
formation, see mkdev{PiDM),) 

Standards Conformance 



shl is conformant with: 

AT&TSVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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sleep 

suspends execution for an interval 

Syntax 

sleep time 

Description 



sleep suspends execution for time seconds. It is used to execute a 
command after a certain amount of time as in: 

(sleep 105; command)& 

or to execute a command every so often, as in: 

while true 
do 

command 
sleep 37 

done 

See Aiso 



alarm(S), sleep(S) 

Notes 



It is recommended that time be less than 65536 seconds. If this 
amount is exceeded, time will be arbitrarily set to some value less 
than 65536 seconds. 

Standards Conformance 



sleep is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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sort 

sorts and merges files 

Syntax 



sort [-emu] [-ooutput] [-ykmem] [-zreesz] [-dfiMnr] [-btx] [+posl] 
[-pos2] [files] 

Description 



sort sorts lines of all the named files together and writes the result on 
the standard output. The standard input is read if - is used as a file 
name or if no input files are named. 

Comparisons are based on one or more sort keys extracted from each 
line of input. By default, there is one sort key, the entire input line, 
and ordering is determined by the collating sequence defined by the 
locale (see locale (M)). 

The following options alter the default behavior: 

-c Check that the input file is sorted according to the ordering 
rules; give no output unless the file is out of sort. 

-m Merge only, the input files are already sorted. 

-u Unique: suppress all but one in each set of lines having equal 
keys. This option can result in unwanted characters placed at 
the end of the sorted file. 

-ooutput 

The argument given is the name of an output file to use instead 
of the standard output. This file may be the same as one of the 
inputs. There may be optional blanks between -o and output. 

-ykmem 

The amount of main memory used by the sort has a large impact 
on its performance. Sorting a small file in a large amount of 
memory is a waste. If this option is omitted, sort begins using a 
system default memory size, and continues to use more space as 
needed. If this option is presented with a value, kmem, sort will 
start using that number of kilobytes of memory, unless the 
administrative minimum or maximum is violated, in which case 
the corresponding extremum will be used. Thus, -yO is 
guaranteed to start with minimum memory. By convention, -y 
(with no argument) starts with maximum memory. 
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-zrecsz 

Causes sort to use a buffer size of recsz bytes for the merge 
phase. Input lines longer than the buffer size will cause sort to 
terminate abnormally. Normally, the size of the longest line 
read during the sort phase is recorded and this maximum is used 
as the record size during the merge phase, eliminating the need 
for the -z option. However, when the sort phase is omitted (-c or 
-m options) a system default buffer size is used, and if this is not 
large enough, the -z option should be used to prevent abnormal 
termination. 

The following options override the default ordering rules. 

-d “Dictionary” order: only letters, digits and blanks (spaces and 
tabs) are significant in comparisons. Dictionary order is defined 
by the locale setting (see locale (M)). 

-f Fold lower case letters into upper case. Conversion between 
lowercase and uppercase letters are governed by the locale set- 
ting (see locale (M)). 

-i Ignore non-printable characters in non-numeric comparisons. 
Non-printable characters are defined by the locale setting (see 
locale (M)). 

-M Compare as months. The first three non-blank characters of the 
field are folded to upper case and compared so that “JAN” < 
“FEB” < ... < “DEC”. Invalid fields compare low to “JAN”. 
The -M option implies the -b option (see below). 

-n An initial numeric string, consisting of optional blanks, an 
optional minus sign, and zero or more digits with optional 
decimal point, is sorted by arithmetic value. The -n option 
implies the -b option (see below). Note that the -b option is 
only effective when restricted sort key specifications are in 
effect. 

-r Reverse the sense of comparisons. 

When ordering options appear before restricted sort key specifica- 
tions, the requested ordering rules are applied globally to all sort keys. 
When attached to a specific sort key (described below), the specified 
ordering options override all global ordering options for that key. 

The notation +posl -pos2 restricts a sort key to one beginning at posl 
and ending at pos2. The characters at positions posl and pos2 are 
included in the sort key (provided that pos2 does not precede posl ). A 
missing -pos2 means the end of the line. 
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Specifying posl and pos2 involves the notion of a field (a minimal 
sequence of characters followed by a field separator or a newline). By 
default, the first blank (space or tab) of a sequence of blanks acts as 
the field separator. All blanks in a sequence of blanks are considered 
to be part of the next field; for example, all blanks at the beginning of 
a line are considered to be part of the first field. The treatment of field 
separators can be altered using the options: 

-tx Use X as the field separator character; x is not considered to be 
part of a field (although it may be included in a sort key). Each 
occurrence of x is significant (e.g., xx delimits an empty field). 

-b Ignore leading blanks when determining the starting and ending 
positions of a restricted sort key. If the -b option is specified 
before the first +posl argument, it will be applied to all ■{‘posi 
arguments. Otherwise, the b flag may be attached indepen- 
dently to each +posl or -pos2 argument (see below). 

Posl and pos2 each have the form m.n optionally followed by one or 
more of the flags b, d, f, i, n, or r. A starting position specified by 
+w.n is interpreted to mean the n+lst character in the m+lst field. A 
missing ,n means .0, indicating the first character of the m+lst field. If 
the b flag is in effect, n is counted from the first non-blank in the 
m+lst field; +m.0b refers to the first non-blank character in the m+lst 
field. 

A last position specified by -mm is interpreted to mean the nth charac- 
ter (including separators) after the last character of the mth field. A 
missing m means .0, indicating the last character of the mth field. If 
the b flag is in effect, n is counted from the last leading blank in the 
m+lst field; -m. lb refers to the first non-blank in the m+lst field. 

When there are multiple sort keys, later keys are compared only after 
all earlier keys compare equal. Lines that otherwise compare equal 
are ordered with all bytes significant. 

Examples 



Sort the contents of infile with the second field as the sort key: 
sort +1-2 infile 

Sort, in reverse order, the contents of infilel and infile2 , placing the 
output in outfile and using the first character of the second field as the 
sort key: 

sort -r -0 outfile +1.0-1.2 infilel infile2 

Sort, in reverse order, the contents of infilel and infile2 using the first 
non-blank character of the second field as the sort key: 
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sort -r +1. Ob -1.1b infilel infile2 

Print the password file (passwd(F)) sorted by the numeric user ID (the 
third colon-separated field): 

sort -t: +2n -3 /etc/passwd 

Print the lines of the already sorted file infile, suppressing all but the 
first occurrence of lines having the same third field (the options -um 
with just one input file make the choice of a unique representative 
from a set of equal lines predictable): 

sort -um +2 -3 infile 



Files 



/usr/tmp/stm??? 

See Also 



coltbl(M), comm(C), join(C), locale(M), uniq(C) 

Diagnostics 



Comments and exits with non-zero status for various trouble condi- 
tions (e.g., when input lines are too long), and for disorders discovered 
under the -c option. When the last line of an input file is missing a 
newline character, sort appends one, prints a warning message, and 
continues. 

Standards Conformance 



sort is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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spell, hashmake, spellin, hashcheck 

finds spelling errors 

Syntax 



spell [ -V ] [ -b ] [ -X ] [ -1 ] [ -i ] [ +local_file ] [ files ] 

/usr/lib/ spell/hashmake 

/usr/lib/spell/spellin n 

/usr/lib/ spell/hashcheck spelling_list 

Description 



spell collects words from the named files and looks them up in a spel- 
ling list. Words that neither occur among nor are derivable (by apply- 
ing certain inflections, prefixes, and/or suffixes) from words in the 
spelling list are printed on the standard output. If no files are named, 
words are collected from the standard input. 

spell ignores most troff (CT), tbl (CT), and eqn(CT) constructions. 

Under the -v option, all words not literally in the spelling list are 
printed, and plausible derivations from the words in the spelling list 
are indicated. 

Under the -b option, British spelling is checked. Besides preferring 
centre, colour, programme, speciality, travelled, etc., this option 
insists upon -ise in words like standardise. 

Under the -x option, every plausible stem is printed with = for each 
word. 

By default, spell (like derojf{Cl)) follows chains of included files (.so 
and .nx troff{CT) requests), unless the names of such included files 
begin with /usr/lib. Under the -1 option, spell will follow the chains of 
all included files. Under the -i option, spell will ignore all chains of 
included files. 

Under the +local Jile option, words found in local Jile are removed 
from spell ’s output. Local Jile is the name of a user-provided file that 
contains a sorted list of words, one per line. With this option, the user 
can specify a set of words that are correct spellings (in addition to 
speirs own spelling list) for each job. 
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The spelling list is based on many sources, and while more haphazard 
than an ordinary dictionary, it is also more effective with respect to 
proper names and popular technical words. Coverage of the special- 
ized vocabularies of biology, medicine, and chemistry is light. 

Pertinent auxiliary files may be specified by name arguments, indi- 
cated below with their default settings (see FILES). Copies of all out- 
put are accumulated in the history file. The stop list filters out 
misspellings (e.g., thier=thy-y+ier) that would otherwise pass. 

Three routines help maintain and check the hash lists used by spell : 

hashmake Reads a list of words from the standard input and writes 
the corresponding nine-digit hash codes on the standard 
output. 

spellin n Reads n hash codes from the standard input and writes a 
compressed, or hashed spelling list , such as 
! usr! lib! spell! hlista or lusrilibi spell! Mistb , on the stan- 
dard output. Information about the hash coding is 
printed on standard error. 

hashcheck Reads a compressed, or hashed spelling Jist , such as 
! usr! lib! spell! hlista or ! usr! lib! spell! hlistb , and recreates 
the nine-digit hash codes for all the words in it, writing 
these codes on the standard output. 

Examples 

This example adds the words in newwords to the on-line dictionary 
{! usr! lib! spell! hlista): 

cd /usr/lib/spell 

cat newwords I ./hashmake I sort -u > newcodes 
cat hlista I ./hashcheck > hashcodes 
cat newcodes hashcodes I sort -u > newhash 
cat newhash I ./spellin ‘cat newhash I wc -1‘ > hlist 

mv hlista hlista.OO 
mv hlist hlista 

cd /usr/dict 

cat newwords words I sort -du > tempwords 
mv words words.OO 
mv tempwords words 

Remember to remove all temporary files after you are sure everything 
works. 
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The following example removes words from the on-line dictionary. 
You should first make a copy of /usr/dict/ words that does not have the 
words you want to remove. Make sure the file is sorted in alphabetical 
order. Then, follow these steps: 

cd /usrAib/spell 

cat /usr/dict/words I ./hashmake > hashcodes 

cat hashcodes I ./spellin ‘cat hashcodes I wc -1‘ > newhlist 

mv hlista hlista.OO 
mv newhlist hlista 

Note that when you are manipulating large text, hash and hash code 
files, you should use cat (C) to open the files, since they may be 
extremely large. 

Files 



D_SPELL=/usr/lib/spell/hlist[ab] 

S_SPELL=/usr/lib/spell/hstop 
H_SPELL=/usrAib/spell/spellhist 
/usr/lib/ spell/spellprog 



hashed spelling lists, American & 
British 

hashed stop list 
history file 
program 



See Also 



deroffCCT), eqn(CT), sed(C), sort(C), tbl(CT), tee(C), tro£f(CT) 

Notes 



The spelling list coverage is uneven; new installations will probably 
wish to monitor the output for several months to gather local addi- 
tions; typically, these are kept in a separate local file that is added to 
the hashed spelling list via spellin . 

By default, logging of errors to /usr/lib/spell/spellhist is turned off. 

D_SPELL and S_SPELL can be overridden by placing alternate 
definitions in your environment. 

Standards Conformance 



hashcheck, hashmake and spellin are conformant with: 
AT&T SVID Issue 2, Select Code 307-127. 

spell is conformant with; 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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spline 

interpolates smooth curve 

Syntax 

spline [ option ] ... 

Description 



spline takes pairs of numbers from the standard input as abscissas and 
ordinates of a function. It produces a similar set, which is approxi- 
mately equally spaced and includes the input set, on the standard out- 
put. The cubic spline output has two continuous derivatives, and 
enough points to look smooth when plotted. 

The following options are recognized, each as a separate argument. 

-a Supplies abscissas automatically (they are missing from the 
input); spacing is given by the next argument, or is assumed to 
be 1 if next argument is not a number. 

-k The constant k used in the boundary value computation 

yo = ’ • • • » 

is set by the next argument. By default ^ = 0. 

-n Spaces output points so that approximately n intervals occur 
between the lower and upper x limits. (Default n = 100.) 

-p Makes output periodic, i.e. matches derivatives at ends. First 
and last input values should normally agree. 

-X Next 1 (or 2) arguments are lower (and upper) x limits. Nor- 
mally these limits are calculated from the data. Automatic 
abscissas start at lower limit (default 0). 

Diagnostics 



When data is not strictly monotone in x, spline reproduces the input 
without interpolating extra points. 

Notes 



A limit of 1000 input points is silently enforced. 
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split 

splits a file into pieces 

Syntax 

split [ -« ] [ file [ name ] ] 

Description 



split reads file and writes it in as many n-line pieces as necessary 
(default 1000), onto a set of output files. The name of the first output 
file is name with aa appended, and so on lexicographically. If no out- 
put name is given, x is default. 

If no input file is given, or if a dash (-) is given instead, the standard 
input file is used. 

See Aiso 



bfs(C), csplit(C) 

Standards Conformance 



split is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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strings 

find the printable strings in an object file 

Syntax 

strings [-] [-o] [ -number ] filename ... 

Description 



strings looks for ASCII strings in a binary file. A string is any 
sequence of four or more printing characters ending with a newline or 
a null character. Unless the - flag is given, strings only looks in the 
initialized data space of object files. If the -o flag is given, then each 
string is preceded by its decimal offset in the file. If the -number flag 
is given then number is used as the minimum string length rather than 
4. 

strings is useful for identifying random object files and many other 
things. 

See Also 



hd(C), od(C) 

Credit 



This Utility was developed at the University of California at Berkeley 
and is used with permission. 
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stty 

sets the options for a terminal 

Syntax 

stty [ -a ] [ -g ] [ options ] 

Description 



Stty sets certain terminal I/O options for the device that is the current 
standard input; without arguments, it reports the settings of certain 
options. With the -a option, stty reports all of the option settings. The 
-g option causes stty to output the current stty settings of the terminal 
as a list of twelve hexadecimal numbers seperated by colons. This 
output may be used as a command line argument to stty to restore 
these settings later on. It is a more compact form than stty -a. For 
example, the following shell script uses stty -g to store the current stty 
settings, then turns off character echo while reading a line of input. 
The stored stty values are then restored to the terminal: 



echo "Enter your secret code: \c” 

old='stty -g' 

stty -echo intr "a 

read code 

stty $old 

The various modes are discussed in several groups that follow. 
Detailed information about the modes listed in the first four groups 
may be found in termio(M), options in the last group are implemented 
using options in the previous groups. Refer to vidi{C) for hardware 
specific information that describes control modes for the video moni- 
tor and other display devices. 



Common Control Modes 



parenb (-parenb) 

Enables (disables) parity generation and detection. 



parodd (-parodd) 

Selects odd (even) parity. 



cs5 cs6 cs7 cs8 

Selects character size (see termio(}A)). 
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0 Hangs up phone line immediately. 

50 75 no 134 150 200 300 600 
1200 1800 2400 4800 9600 19200 

Sets terminal baud rate to the number given, if possible. 

ispeed 50 75 110 134 150 
1200 1800 3400 4800 9600 19200 

sets terminal output baud rate separately. 

ospeed 50 75 110 134150 
1200 1800 3400 4800 9600 19200 

sets terminal input baud rate separately. 

hupcl (-hupcl) 

Hangs up (does not hang up) phone connection on last close, 
hup (-hup) 

Same as hupcl (-hupcl). 
cstopb (-cstopb) 

Uses two(one) stop bits per character, 
cread (-cread) 

Enables (disables) the receiver, 
clocal (-clocal) 

Assumes a line without (with) modem control, 
ctsflow (-ctsflow) 

Enables (disables) CTS protocol for a modem or non-modem line, 
rtsflow (-rtsflow) 

Enables (disables) RTS signaling for a modem or non-modem line, 
dtrflow (-dtrflow) 

Enables (disables) DTR output flow control, 
dsrflow (-dsrflow) 

Enables (disables) DSR input flow control. Valid for non-modem 
lines only (i.e., when clocal is set.) 



Input Modes 

ignbrk (-ignbrk) 

Ignores (does not ignore) break on input, 
brkint (-brkint) 

Signals (does not signal) INTERRUPT on break. 
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ignpar (-ignpar) 

Ignores (does not ignore) parity errors, 
parinrk (-parmrk) 

Marks (does not mark) parity errors (see tty (M)). 
inpck (-inpck) 

Enables (disables) input parity checking, 
istrip (-istrip) 

Strips (does not strip) input characters to 7 bits, 
inter (-inlcr) 

Maps (does not map) NL to CR on input, 
igner (-igner) 

Ignores (does not ignore) CR on input, 
ierni (-ierni) 

Maps (does not map) CR to NL on input, 
iucic (-iuclc) 

Maps (does not map) uppercase alphabetics to lowercase on input, 
ixon (-ixon) 

Enables (disables) START/STOP output control. Output is stopped 
by sending an ASCII DC3 and started by sending an ASCII DC I. 

ixany (-ixany) 

Allows any character (only DCl) to restart output, 
ixoff (-ixoff) 

Requests that the system send (not send) START/STOP characters 
when the input queue is nearly empty/full. 



Output Modes 
opost (-opost) 

Post-processes output (does not post-process output; ignores all 
other output modes). 

olcuc (-olcuc) 

Maps (does not map) lowercase alphabetics to uppercase on out- 
put. 

onlcr (-onlcr) 

Maps (does not map) NL to CR-NL on output, 
ocrnl (-oerni) 

Maps (does not map) CR to NL on output. 
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onocr (-onocr) 

Does not (does) output CRs at column zero, 
onlret (-onlret) 

On the terminal NL performs (does not perform) the CR function, 
ofill (-ofill) 

Uses fill characters (use timing) for delays, 
ofdel (-ofdel) 

Fill characters are DELETES (NULs). 

crO crl cr2 cr3 

Selects style of delay for RETURNS (see tty(M)). 

nlO nil 

Selects style of delay for LINEFEEDS (see tty(M)). 

tabO tabl tab! tab3 

Selects style of delay for horizontal TABs (see tty(M)). 
bsO bsl 

Selects style of delay for BACKSPACES (see tty(M)). 

mm 

Selects style of delay for FORMFEEDS (see tty(M)), 

vtO vtl 

Selects style of delay for Vertical TABs (see (M)). 



Local Modes 
isig (-isig) 

Enables (disables) the checking of characters against the special 
control characters INTERRUPT and QUIT. 

icanon (-icanon) 

Enables (disables) canonical input (ERASE and KILL processing), 
xcase (-xcase) 

Canonical (unprocessed) upper/lowercase presentation, 
echo (-echo) 

Echoes back (does not echo back) every character typed, 
echoe (-echoe) 

Echoes (does not echo) ERASE character as a SPACEBAR string. 
Note: this mode will erase the ERASE character on many CRT ter- 
minals; however, it does not keep track of column position and, as 
a result, may be confusing on escaped characters, TABs, and 
BACKSPACES. 
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echok (-echok) 

Echoes (does not echo) NL after KILL character. 

Ifkc (-Ifkc) 

TTie same as echok (-echok); obsolete. 

echonl (-echonl) 

Echoes (does not echo) NL. 

noflsh (-noflsh) 

Disables (enables) flush after INTERRUPT or QUIT, 
iexten (-iexten) 

Enables extended implementation (implementation-defined) func- 
tion. 

tostop (-tostop) 

Disables/enables background process group to write to controlling 
terminal only if job control is supported. 



Control Assignments 
control-character C 

control-character C Sets control-character to C, where control- 
character is erase, kill, interrupt, quit, eof, eol, switch, or susp. If 
C is preceded by a caret O') (escaped from the shell), then the value 
used is the corresponding CTRL character (e.g., “"D” is a CTRL-D 
); is interpreted as DELETE and is interpreted as 

undefined. 

min i, time i (0<kl27) 

When -icanon is set, and one character has been received, read 
requests are not satisfied until at least min characters have been 
received or the timeout value time has expired and one character 
has been received. See tty(C). 

line i 

Sets the line discipline to i (0 < / < 127 ). There are currently no 
line disciplines implemented. 



Combination Modes 

evenp or parity 

Enables parenb and cs7. 

oddp 

Enables parenb, es7, and parodd. 
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-parity, -evenp, or -oddp 

Disables parenb, and sets cs8. 

raw (-raw or cooked) 

Enables (disables) raw input and output (no ERASE, KILL, INTER- 
RUPT, QUIT, EOT, or output post-processing). 

nl (-nl) 

Unsets (sets) icrnl, onlcr. In addition -nl unsets inlcr, igncr, 
ocrnl, and onlret. 

lease (-lease) 

Sets (unsets) xcase, iuclc, and olcuc. 

LCASE (-LCASE) 

Same as lease (-lease). 

tabs (-tabs or tab3) 

Preserves (expands to spaces) tabs when printing. 

ek Resets ERASE and KILL characters back to normal CTRL-H and 
CTRL-U. 

sane 

Resets all modes to some reasonable values. Useful when a 
terminaTs settings have been hopelessly scrambled. 

term 

Sets all modes suitable for the terminal type, TERM, where TERM 
is one of tty 33, tty 37, vt05, tn300, ti700, or tek. 

See Also 



console(M), ioctl(S), vidi(C), tty(M), termio(M), termios(M) 

Notes 



Many combinations of options make no sense, but no checking is per- 
formed. 

Standards Conformance 



stty is conformant with: 

AT&TSVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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SU 

makes the user a super-user or another user 

Syntax 



SU [ - ] [ name [ arg . . . ] ] 

Description 



SU allows authorized users to become another user without logging 
off. The default user name is root (i.e., super-user). 

SU cannot be used to simply assume the login of another user in this 
implementation of UNIX. Instead, su can be used under four cir- 
cumstances: 

• The super-user can “su” to any account. 

• An administrative user with the su authorization can “su” to 
the super-user account. 

• A user can “su” to their own account (silly, but possible). 

• A system daemon can “su” to an account. 

To use sUy the appropriate password must be supplied (unless you are 
already a super-user). If the password is correct, su will execute a 
new shell with the effective user ID set to that of the specified user. 
(The LUID is not changed.) The new shell will be the optional pro- 
gram named in the shell field of the specified user’s password file 
(/bin/sh if none is specified (see sh(C)). To restore normal user ID 
privileges, press EOF (Ctrl-D) to the new shell. 

Any additional arguments given on the command line are passed to 
the program invoked as the shell. When using programs like sh(C), an 
arg of the form -c string executes string via the shell and an arg of -r 
gives the user a restricted shell. 

The following statements are true only if the optional program named 
in the shell field of the specified user’s password file entry is like 
sh(C). If the first argument to su is a -, the environment is changed to 
what would be expected if the user actually logged in as the specified 
user. This is done by invoking the program used as the shell with an 
argO value whose first character is -, thus causing first the system’s 
profile (/etc/profile) and then the specified user’s profile (.profile in 
the new HOME directory) to be executed. Otherwise, the environ- 
ment is passed along with the possible exception of $PATH, which is 
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set to /bin:/etc:/usr/bin for root. Note that if the optional program 
used as the shell is /bin/sh, the user’s .profile can check argO for -sh 
or -SU to determine if it was invoked by login(M) or su(C\ respec- 
tively. If the user’s program is other than /bin/sh, then .profile is 
invoked with an argO of -program by both /ogm(M) and su(C). 

The file /etc/default/su can be used to control several aspects of how 
SU is used. Several entries can be placed in /etc/default/su: 

SULOG Name of log file to record all attempts to use su. Usually 
/usr/adm/sulog. If not set, no logfile is kept. (See example 
below.) 

PATH The PATH environment variable to set for non-root users. 

If not set, it defaults to “:/bin:/usr/bin.” The current 
PATH environment variable is ignored. 

SUPATH When invoked by root, the path is set by default to 
“/bin:/usr/bin:/etc”, unless this variable is defined.. The 
current PATH is ignored. 

CONSOLE Attempts to use su are logged to the named device, 
independently of SULOG. 

For example, if you want to log all attempts by users to become root, 
create the file /etc/default/su. In this file, place a string similar to: 
SULOG=/usr/adm/sulog This causes all attempts by any user to switch 
user IDs to be recorded in the file /usr/adm/sulog. This filename is 
arbitrary. The su logfile records the original user, the UID of the su 
attempt, and the time of the attempt. If the attempt is successful, a 
plus sign (-I-) is placed on the line describing the attempt. A minus 
sign (-) indicates an unsuccessful attempt. 

Examples 



To become user bin while retaining your previously exported environ- 
ment, enter: 

su bin 

To become user bin but change the environment to what would be 
expected if bin had originally logged in, enter: 

su - bin 

To execute command with the temporary environment and permissions 
of user bin, enter: 

su - bin -c ''command args'' 
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Files 



/etc/passwd 


The system password file 


/etc/default/su 


Optional file containing control options 


/etc/profile 


The system profile 


$HOME/.profile 


The user profile 


See Also 





env(C), environ(M), login(M), passwd(F), profile(M), sh(C), auths(C) 

Standards Conformance 



SU is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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sum 

calculates checksum and counts blocks in a file 

Syntax 



sum [ -r ] file 

Description 



sum calculates and prints a 16-bit checksum for the named file, and 
also prints the number of 512-byte blocks in the file. It is typically 
used to look for bad spots, or to validate a file communicated over a 
transmission line. The option -r causes an alternate algorithm to be 
used in computing the checksum. 

See Also 



cmchk(C), machine(HW), wc(C) 

Diagnostics 



“Read error” is indistinguishable from end-of-file on most devices; 
check the block count. 

Standards Conformance 



sum is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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swconfig 

produces a list of the software modifications to the 
system 

Syntax 



swconfig [-a] [-p] 

Description 



swconfig displays the modifications to the system software since its 
initialization, in much the same way that hwconfig tells the user what 
hardware is installed on the system. The program can tell the user 
what sets have been installed or removed from the system, as well as 
what release and what parts of the packages were installed at that 
time. 

Options 



Additional flags let the user ask to see all of the description of each 
installation on the system. 

The default behavior is simple so that the information is displayed 
quickly. Additional flags can be used to perform more complex mani- 
pulations. Updates are recognized and noted as such. The release 
number is displayed in all cases. 

Without options, swconfig generates a display similar to the following 
example: 



Set 



Release Notes 



Operating System 2.3.1a 
International XENIX O.S. Supplem 2.0.0e 
Develofxnent System 2.3.0b 



partially removed 
partially installed 
removed 



-a The -a flag lists all the information contained in 
/usrAib/custom/history, but sorted by date. It groups prod- 
ucts that were installed at the same time, but displays 
entries in reverse chronological order. 

-p The flag -p is used to display package information in addi- 
tion to the default information. A list of all the packages in 
a set is stored and their installed status tracked by the 
sequence of information in /usr/lib/custom/history. 
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Examples 



Here is a sample output using the -a option: 

Set: Operating System (prd = xos) 

Fri Mar 17 07:51:02 PST 1989 

removed successful Release 2.3.1a Type: 386GT 

Packages: HELP MOUSE 

Fri Mar 17 10:43:09 PST 1989 

removed successful Release 2.3.1a Type: 386GT 

Packages: VSH 

Set: International XENIX O.S. Supplement (prd = sup. os) 

Fri Dec 16 10:32:53 PST 1988 

installed successful Release 2.0.0e Type: n286 

Packages: RTSUP BASE SYSADM FILE 

Fri Dec 16 11:03:37 PST 1988 

installed successful Release 2.0.0e Type: n286 

Packages: MAPFILE 

Here is a sample output generated by the -p option: 



Set 




Release 


Notes 


Packages 


Operating System 




2.3.1a 


removed 


HELP MOUSE 


Operating System 




2.3.1a 


removed 


VSH 


International XENIX O.S. 


Supplem 


2.0.0e 


installed 


RTSUP BASE 










SYSADM FIL 


International XENIX O.S. 


Supplem 


2.0.0e 


installed 


MAPFILE 


Develoment System 




2.3.0b 


removed 


ALL 



See Also 



custom(ADM) 
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tabs 

set tabs on a terminal 

Syntax 



tabs [tabspec] [-Ttype] [+mn] 

Description 



The tabs command sets the tab stops on the user’s terminal according 
to the tab specification tabspec y after clearing any previous settings. 
The user’s terminal must have remotely-settable hardware tabs. 

tabspec Four types of tab specification are accepted for tabspec. 
They are described below: canned (-code), repetitive (-n), 
arbitrary (nl,n2 and file (—file). If no tabspec is given, 
the default value is -8, i.e., “standard” Altos UNIX System 
V tabs. The lowest column number is 1. Note that for tabs, 
column 1 always refers to the leftmost column on a terminal, 
even one whose column markers begin at 0, e.g., the DASI 
300, DASI 300s, and DASI 450. 

-code Use one of the codes listed below to select a canned set of 
tabs. The legal codes and their meanings are as follows: 

-a 1,10,16,36,72 

Assembler, IBM S/370, first format 

-a2 1,10,16,40,72 

Assembler, IBM S/370, second format 

-c 1,8,12,16,20,55 

COBOL, normal format 

-c2 1,6,10,14,49 

COBOL compact format (columns 1-6 omitted). 
Using this code, the first typed character corre- 
sponds to card column 7, one space gets you to 
column 8, and a tab reaches column 12. Files 
using this tab setup should include a format specif- 
ication as follows [sQC fspec(F)]: 

<:t-c2 m6 s66 d:> 

-c3 1,6,10,14,18,22,26,30,34,38,42,46,50,54,58,62,67 

COBOL compact format (columns 1-6 omitted), 
with more tabs than -c2. This is the recommended 
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format for COBOL. The appropriate format specif- 
ication is [see fspec(¥)]: 

<:t-c3 m6 s66 d:> 

-f 1,7,11,15,19,23 

FORTRAN 

-p 1,5,9,13,17,21,25,29,33,37,41,45,49,53,57,61 

PL/I 

-s 1,10,55 

SNOBOL 

-u 1,12,20,44 

UNI VAC 1100 Assembler 

A repetitive specification requests tabs at columns l+«, 
l+2*«, etc. Of particular importance is the value 8: this 
represents the “standard” Altos UNIX System V tab setting, 
and is the most likely tab setting to be found at a terminal. 
Another special case is the value 0, implying no tabs at all. 

nl ,n2,... The arbitrary format permits the user to type any chosen set 
of numbers, separated by commas, in ascending order. Up to 
40 numbers are allowed. If any number (except the first one) 
is preceded by a plus sign, it is taken as an increment to be 
added to the previous value. Thus, the formats 1,10,20,30, 
and 1,10,+ 10,+ 10 are considered identical. 

-file If the name of a file is given, tabs reads the first line of the 
file, searching for a format specification [see fspec(fi)\. If it 
finds one there, it sets the tab stops according to it, otherwise 
it sets them as -8. This type of specification may be used to 
make sure that a tabbed file is printed with correct tab set- 
tings, and would be used with the pr{C) command: 

tabs - file; pr file 



Any of the following also may be used; if a given flag occurs more 
than once, the last value given takes effect: 

’Ttype tabs usually needs to know the type of terminal in order to 
set tabs and always needs to know the type to set margins. 
type is a name listed in termQA), If no -T flag is supplied, 
tabs uses the value of the environment variable TERM. If 
TERM is not defined in the environment [see environ (M)]y 
tabs tries a sequence that will work for many terminals. 

+mn The margin argument may be used for some terminals. It 
causes all tabs to be moved over n columns by making 
column n+7 the left margin. If +m is given without a value 
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of n, the value assumed is 10. For a TermiNet, the first value 
in the tab list should be 1, or the margin will move even 
further to the right. The normal (leftmost) margin on most 
terminals is obtained by +m0. The margin for most termi- 
nals is reset only when the +m flag is given explicitly. 

Tab and margin setting is performed via the standard output. 



Examples 



tabs -a 


example using -code (canned specification) to set tabs 
to the settings required by the IBM assembler: 




columns 1, 10, 16, 36, 72. 


tabs -8 


example of using -n specification), where n 

is 8, causes tabs to be set every eighth position: 




l+Cl’^S), l+(2*8), ... which evaluate to columns 
9,17,... 


tabs 1,8,36 


example of using «7,«2,... (arbitrary specification) to 
set tabs at columns 1, 8, and 36. 


tabs -$HOME/fspec.list/att4425 

example of using -file (file specification) to indicate 
that tabs should be set according to the first line of 
$HOME/fspec.list/att4425 [see fspec(F )] . 


Diagnostics 




illegal tabs 


when arbitrary tabs are ordered incorrectly 


illegal increment when a zero or missing increment is found in an 
arbitrary specification 


unknown tab code when a canned code cannot be found 


can't open 


if -fie option used and file can’t be opened 


file indirection 


if -file option used and the specification in that 
file points to yet another file. Indirection of this 
form is not permitted 


See Also 




newform(C), 


pr(C), tput(C), fspec(F), terminfo(F), environ(M), 
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term(M) 

Notes 



There is no consistency among different terminals regarding ways of 
clearing tabs and setting the left margin. 

tabs clears only 20 tabs (on terminals requiring a long sequence), but 
is willing to set 64. 

The tabspec used with the tabs command is different from the one 
used with the newform(C) command. For example, tabs -8 sets every 
eighth position; whereas newform -i-8 indicates that tabs are set 
every eighth position. 

Standards Conformance 



tabs is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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tail 

displays the last part of a file 

Syntax 

tail [ ±[numberj[lbc] [ -f ] ] [ file ] 

Description 



tail copies the named file to the standard output beginning at a desig- 
nated place. If no file is named, the standard input is used. 

Copying begins at distance ^number from the beginning, or ’‘number 
from the end of the input (if number is null, the value 10 is assumed). 
Number is counted in units of lines, blocks, or characters, according to 
the appended option I, b, or c. When no units are specified, counting 
is by lines. 

With the -f (“follow”) option, if the input file is not a pipe, the pro- 
gram will not terminate after the line of the input file has been copied, 
but will enter an endless loop, wherein it sleeps for a second and then 
attempts to read and copy further records from the input file. Thus it 
may be used to monitor the growth of a file that is being written by 
some other process. For example, the command: 

tail -f file 

will print the last ten lines of file, followed by any lines that are 
appended to file between the time tail is initiated and killed. 

See Also 



dd(C) 

Notes 



Tails relative to the end of the file are kept in a buffer, and thus are 
limited to approximately 300 lines. Unpredictable results can occur if 
character special files are “tailed’ ’. 

Standards Conformance 



tail is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 
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and 1'he X/Open Portability Guide II of January 1987. 
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tape, mcart 

magnetic tape maintenance program 

Syntax 

tape [ -c ] [ -f ] [ -a arg ] command [ device ] 
mcart command [ device ] 

Description 



tape sends commands to and receives status from the tape subsystem. 
tape can communicate with QIC-02 cartridge tape drives, SCSI tape 
drives, and QIC-40, QIC-80 and Irwin mini-cartridge tape drives. 
(The mcart program is automatically invoked by tape when options 
specific to the Irwin driver are used.) 

tape reads /etc/default/tape to find the default device name for send- 
ing commands and receiving status. For example, the following line 
in /etc/default/tape will cause tape to communicate with the QIC-02 
cartridge tape device: 

device = /dev/xctO 

If a device name is specified on the command line, it overrides the 
default device, tape queries the device to determine its device type. 
If the device does not respond to the query, for example if the car- 
tridge tape driver is from an earlier release, tape will print a warning 
message and assume the device is a QIC-02 cartridge tape. 

You can explicitly specify the type of the device by using the device 
type flags, as follows: 

-c QIC-02 cartridge tape 

-s SCSI tape 

-f QIC-40 mini-cartridge tape 

-8 QIC-80 mini-cartridge tape 

-i Irwin mini-cartridge tape 

The -a flag allows you to pass an argument to commands that can use 
them. The only command that currently can take an argument is the 
format command, and a format argument is only valid with QIC-40 
and QIC-80 tape drives. 
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The following commands can be used with the various tape drivers 
supported under UNIX. The letters following each description indi- 
cate which drivers support each command: 

A All drivers 

C QIC-02 cartridge tape driver 

S SCSI tape driver 

F QIC-40 and QIC-80 mini-cartridge tape drivers 

I Irwin mini-cartridge tape driver 



amount 

Report amount of data in current or last transfer. (C,S,F) 
erase 

Erase and retension the tape cartridge. (C,S,F) 
reset 

Reset tape controller and tape drive. Clears error conditions and 
returns tape subsystem to power-up state. (C,S,F) 

reten 

Retension tape cartridge. Should be used periodically to remedy 
slack tape problems. Tape slack can cause an unusually large 
number of tape errors. (A) 

rewind 

Rewind to beginning of tape. (A) 
status 

The status output looks like this: 

status: status message 

soft errors: n 

underruns: m 

status message is a report of the current status of the drive; “no 
cartridge,” “write protected,” or “beginning of tape” are typical 
status messages. 

soft errors is the number of recoverable errors that occurred during 
the last tape operation. A recoverable error is one which is 
correctable by the drive or controller. An example of a non- 
recoverable “hard” error is an attempt to write to a write- 
protected cartridge. Note that if the number of soft errors greatly 
exceeds the manufacturer’s specifications, the drive may require 
service or replacement. 
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underruns is the number of times the tape drive had to stop and 
restart due to tape buffer underflows. Underruns are not an error 
indication, but that the data transfer did not occur at the drive’s 
maximum data transfer rate. The number of overruns can be 
affected by system load. (C,S,F) 

format 

Format the tape cartridge. Tapes must be formatted before they 
can be used. This command takes approximately one minute per 
megabyte of tape capacity. Note that on Irwin mini-cartridge tape 
drives, blank tapes must be servo-written with the servo command 
before they can be formatted. If an argument is provided with the 
-a flag, the number of tracks specified by the argument will be for- 
matted. Only even numbers less than or equal to the number of 
tracks on the tape are allowed. (See tape(ITW) for more informa- 
tion.) If no argument is given, the entire tape will be formatted. 
(F,I) 

getbb 

Prints a list of bad tape blocks detected during the last tape opera- 
tion. This listing can be saved in a file for use by the putbb com- 
mand. (F) 

map 

Prints out a map of the bad blocks on the tape. The format is a 
series of lines of the format: 

track n: X — ... 

Each represents a good block on the track; an ’X’ represents a 
block marked as bad. (F,I) 

putbb 

Reads a list of bad tape blocks from the standard input and adds 
them to the bad block table on the tape. The format expected by 
putbb is the same as generated by the getbb command. (F) 

rfm 

Wind tape forward to the next file mark. (C,S) 
wfm 

Write a file mark at the current tape position. (G,S) 
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Irwin-specific Commands 



The following commands are all specific to Irwin drives, 
drive 

displays information about the Irwin driver and the tape drive. An 
example display is: 

Special file: /dev/rmcO 
Driver version: 1.0.6a 
Drive type: 285XL 
Drive firmware: AO 
Controller type: SYSFDC 
Unit select (0-3) : 3 

Special file is the name of the special file used to access the driver. 

Driver version is the version of the driver linked with the kernel. 

Drive type is an “equivalent” tape drive model number as deter- 
mined by the MC driver. Since the exact model number of the tape 
drive depends on the drive’s form factor and whether the drive is 
mounted in its own cabinet, the equivalent model number may not 
be the exact model of the installed tape drive. The following is a 
list of equivalent drives: 

110: 110,310,410 

1 201XL] : 1 20, 220, 320, 420, 720, 2020 

125: 125,225,325,425,725 

145 [XL]: 145, 245, 345, 445, 745, 2040 

165: 165,265,465,765 

285XL: 285, 485, 785, 2080 

287XL: 287,487,787,2120 

The brackets in the 120[XL] and 145 [XL] mean the letters “XL” 
may or may not be present. When the letters “XL” appear, the 
drive is capable of servo writing extra long (i.e., 307.5 foot 
DC2120) tapes. 

Note: When this field displays “125/145,” either a 125 drive or an 
early model 145 drive with a DCIOOO is present, the driver can’t 
distinguish between the two. A 125 drive will only accept a 
DCIOOO cartridge (a DC2000 or DC2120 will not fit). A 145 drive 
will accommodate DCIOOO, DC2000, or DC2120 cartridges. 

Drive firmware is the firmware part number and revision level. 
This line is present only for drives which report this information. 
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Controller type: is a mnemonic for the floppy controller to which 
the tape drive is attached: 



Mnemonic Description 

SYSroC System floppy controller 

ALTFDC Alternate floppy controller 

4100MC Irwin 4100MC Micro Channel controller 

4100MCB Second 4100MC Micro Channel controller 

4100 Irwin 4100 PC Bus controller 

4100B Second 4100 PC Bus controller 



Unit select (0-3) gives the controller’s unit select, in the range 0 
through 3. The unit select selects the drive. 



servo 

Prepares a blank tape for formatting by writing servo information 
on each track. This command must be used on blank mini- 
cartridge tapes before they can be used in an Irwin mini-cartridge 
drive. If the tape has been previously servo-written, it must be 
bulk-erased with a commercial tape eraser before it can be servo- 
written again. Normally, a tape should only be servo-written once 
in its lifetime, although it can be formatted with the format com- 
mand many times. 

info 

displays Irwin cartridge information. For example: 

Cartridge state: Formatted 
Cartridge format: 145 

Write protect slider position: RECORD 

Cartridge state is the current state of the cartridge’s format. 

Cartridge format indicates the format on the cartridge’s tape. The 
format is given in a code which is the same as the drive model on 
which the cartridge was originally formatted (see drive and 
for details). When the cartridge is blank, the code has 
the format which would be applied by the format command. 

Write protect slider position is RECORD or PROTECT. 

capacity 

cartridge capacity in 512-byte blocks, 
kapacity 

cartridge capacity in 1024-byte blocks. 

These two commands give the total usable data storage capacity of 
a formatted tape cartridge. Variations in cartridge capacity are due 
to differing numbers of bad blocks. 
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/dev/rStpO 

/dev/nrStpO 

/dev/xStpO 

/dev/rftO 

/dev/xftO 



/dev/rctO 

/dev/nrctO 

/dev/rct2 

/dev/nrct2 

/dev/xctO 



/dev/erctO 

/dev/xctO 

/dev/rctmini 

/dev/xctmini 

/dev/rmcO 



/dev/rmcl 

/dev/mcdaemon 



/etc/default/tape 
Include files: 



/usr/include/sys/tape.h 

/usr/include/sys/ct.h 

/usr/include/sys/ft.h 

/usr/include/sys/ir.h 



See Also 



backup(ADM), cpio(C), dd(C), restore(ADM), tape(HW), tar(C), 
xbackup(ADM), xrestore(ADM) 

Notes 



See rap^(HW) for a list of supported tape drives. 

The amount and reset commands can be used while the tape is busy 
with other operations. All other commands wait until the currently 
executing command has been completed before proceeding. 

When you are using the non-rewinding tape device or the tape com- 
mands rfm and wfm, the tape drive light remains on after the com- 
mand has been completed, indicating that more operations may be 
performed on the tape. The tape rewind command may be used to 
clear this condition. 

For more information on device files, (listed above), see the 
manual page. 

If you use the status command while the tape drive is busy, no mes- 
sage is displayed until the drive is free. 

The amount command doesn’t work with QIC-40 mini-cartridge tape 
devices. 
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tapecnti 

AT&T tape control for QIC-24/QIC-02 tape device 
Syntax 

tapecnti [ -etrw ] [ -p arg ] 

Description 



tapecnti will send the optioned commands to the tape device driver 
sub-device /dev/rmt/cOsO for all commands except “position,” which 
will use sub-device /dev/rmt/cOsOn using the ioctl command function. 
Sub-device /dev/rmt/cOsO provides a rewind on close capability, 
while /dev/rmt/cOsOn allows for closing of the device without rewind. 
Error messages will be written to standard error. 

-e erase tape 

-t retension tape 

-r reset tape device 

-w rewind tape 

-p[n] position tape to “end of file” mark - n 

Erasing the tape causes the erase bar to be activated while moving the 
tape from end to end, causing all data tracks to be erased in a single 
pass over the tape. 

Retensioning the tape causes the tape to be moved from end to end, 
thereby repacking the tape with the proper tension across its length. 

Reset of the tape device initializes the tape controller registers and 
positions the tape at the beginning of the tape mark (BOX). 

Rewinding the tape will move the tape to the BOX. 

Positioning the tape command requires an integer argument. Position- 
ing the tape will move the tape forward relative to its current position 
to the end of the specified file mark. Xhe positioning option used with 
an argument of zero will be ignored. Illegal or out-of-range value 
arguments to the positioning command wilP leave the tape positioned 
at the end of the last valid file mark. 

Options may be used individually or strung together with selected 
options being executed sequentially from left to right in the command 
line. 
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Files 



/u s r/l i b/ta pe/tapecntl 

/dev/rmt/cOsOn 

/dcv/rmt/cOsO 



Notes 



Exit codes and their meanings are as follows: 

exit (1) device function could not initiate properly due to miscon- 
nected cables or poorly inserted tape cartridge. 

exit (2) device function failed to complete properly due to unre- 
coverable error condition, either in the command setup or 
due to mechanical failure. 

exit (3) device function failed due to the cartridge being write 
protected or to the lack of written data on the tape. 

exit (4) device /dev/rmt/cOsOn or /dev/rmt/cOsO failed to open 
properly due to already being opened or claimed by 
another process. 
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tapedump 

dumps magnetic tape to output file 

Syntax 

tapedump [-al-e] [-ol-h] [-btsnnwm] tape device output Jlle 

Description 

tapedump dumps the contents of magnetic tapes according to the 
options specified. Options include conversion from input format to 
user specified output format, specification of input and output block- 
size, and the ability to specify that the dump begin at a specific start 
block on the tape and proceed for a specified number of blocks. 

Options 

Option Value 

tapejdevice The input tape device. 

-a Convert from EBCDIC input to ASCII output. 

-e Convert from ASCII input to EBCDIC output. 

-o Display tape output in octal format. 

-h Display tape output in hexadecimal format. 

-b num skips n input records before starting dump. 

-t num Specify which tape file to begin dump from, 

where num is the tape file sequence number. 

-s num Specify tape block address from which to start dump. 

-n num Specify dump of only num blocks. 

output _file The output filename; standard output is the default. 

Examples 

This command reads a tape starting at block 400 and outputs the 
results in hexadecimal format into a user specified file called 
/tmp/hex.dump: 
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tapedunip -h400 -h IdevIrctO Itmplhexdump 

This command reads an EBCDIC tape and converts the standard out- 
put to ASCII: 

tapedump -a IdevIrctO 

See Also 



sysadmsh(ADM), dd(C), hd(C), od(C), tape(C) 

Notes 



The output file may be specified to be another tape device. 
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tar 

archives files 

Syntax 

tar [ key ] [ files ] 

Description 



tar saves and restores files to and from an archive medium, which is 
typically a storage device such as floppy disk or tape, or a regular file. 
Its actions are controlled by the key argument. The key is a string of 
characters containing at most one function letter and possibly one or 
rtiore function modifiers. Valid function letters are c, t, x, and e. 
Other arguments to the command are files (or directory names) speci- 
fying which files are to be backed up or restored. In all cases, api^ar- 
ance of a directory name refers to the files and (recursively) subdirec- 
tories of that directory. The r and u option cannot be used with tape 
devices. 

The function portion of the key is specified by one of the following 
letters: 

r The named files are written to the end of an existing archive. 

X The named files are extracted from the archive. If a named 

file matches a directory whose contents had been written 
onto the archive, this directory is (recursively) extracted. 
The owner, modification time, and mode are restored (if pos- 
sible). If no files argument is given, the entire contents of 
the archive are extracted. Note that if several files with the 
same name are on the archive, the last one overwrites all 
earlier ones. 

t The names of the specified files are listed each time that 

they occur on the archive. If no files argument is given, all 
the names on the archive are listed. 

u The named files are added to the archive if they are not 

already there, or if they have been modified since last writ- 
ten on that archive. 

c Creates a new archive; writing begins at the beginning of the 

archive, instead of after the last file. 
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The following characters may be used in addition to the letter that 

selects the desired function: 

0,...,9999 

This modifier selects the drive on which the archive is 
mounted. The default is found in the file /etc/default/tar. 

V Normally, tar does its work silently. The v (verbose) option 

causes it to display the name of each file it treats, preceded 
by the function letter. With the t function, v gives more in- 
formation about the archive entries than just the name. 

w Causes tar to display the action to be taken, followed by the 

name of the file, and then wait for the user’s confirmation. If 
a word beginning with y is given, the action is performed. 
Any other input means “no”. 

f Causes tar to use the next argument as the name of the 

archive instead of the default device listed in 
/etc/default/tar. If the name of the file is a dash (-), tar 
writes to the standard output or reads from the standard 
input, whichever is appropriate. Thus, tar can be used as the 
head or tail of a pipeline, tar can also be used to move 
hierarchies with the command: 

cd fromdir; tar cf - . I (cd todir; tar xf -) 

b Causes tar to use the next argument as the blocking factor 

for archive records. The default is 1, the maximum is 20. 
This option should only be used with raw magnetic tape 
archives (see f above). The block size is determined auto- 
matically when reading tapes (key letters x and t). 

F Causes tar to use the next argument as the name of a file 

from which succeeding arguments are taken. 

1 Tells tar to display an error message if it cannot resolve all 

of the links to the files being backed up. If 1 is not specified, 
no error messages are displayed. 

m Tells tar to not restore the modification times. The 

modification time of the file is the time of extraction. 

k Causes tar to use the next argument as the size of an archive 

volume in kilobytes. The minimum value allowed is 250. 
Very large files are split into “extents” across volumes. 
When restoring from a multivolume archive, tar only 
prompts for a new volume if a split file has been partially 
restored. To override the value of k in the default file, 
specify k as 0 on the command line. 
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e Prevents files from being split across volumes (tapes or 

floppy disks). If there is not enough room on the present vol- 
ume for a given file, tar prompts for a new volume. This is 
only valid when the k option is also specified on the com- 
mand line. 

n Indicates the archive device is not a magnetic tape. The k 

option implies this. Listing and extracting the contents of an 
archive are sped because tar can seek over files it wishes to 
skip. Sizes are printed in kilobytes instead of tape blocks. 

p Indicates that files are extracted using their original permis- 

sions. It is possible that a non-super-user may be unable to 
extract files because of the permissions associated with the 
files or directories being extracted. 

A Suppresses absolute filenames. Any leading “/’’characters 

are removed from filenames. During extraction arguments 
given should match the relative (rather than the absolute) 
pathnames. With the c, r, u options the A options can be 
used to inhibit putting leading slashes in the archive 
headers. 

tar reads /etc/default/tar to obtain default values for the device, 
blocking factor, volume size, and the device type (tape or non-tape). 
If no numeric key is specified on the command, tar looks for a line in 
the default file beginning with the string archive-. Following this 
pattern are 4 blank separated strings indicating the values for the de- 
vice, blocking factor, volume size and device type, in that order. A 
volume size of ‘0’ indicates infinite volume length. This entry should 
be modified to reflect the size of the tape volumes used. 

For example, the following is the default device entry from 
/etc/default/tar : 



archive=/dev/f d096dsl5 10 1200 n 

The n in the last field, means that this device is not a tape. Use y for 
tape devices. Any default value may be overridden on the command 
line. The numeric keys (0-7) select the line from the default value 
beginning with archive#^, where # is the numeric key. When the f 
key letter is specified on the command line, the entry "archivef=” is 
used. In this case, the default file entry must still contain 4 strings, but 
the first entry (specifying the device) is not significant. The default 
file /etc/default/tar need not exist if a device is specified on the com- 
mand line. 

Notes 

A critical consideration when creating a tar volume involves the use 
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of absolute or relative pathnames. Consider the following tar com- 
mand examples, as executed from the directory /u/target: 

tar cv /u/target/arrow 

tar cv arrow 

The first command creates a tar volume with the absolute pathname: 
/u/target/arrow. The second yields a tar volume with a relative path- 
name: ./arrow. (The ./ is implicit and shown here as an example, ./ 
should not be specified when retrieving the file from the archive.) 
When restored, the first example results in the file arrow being writ- 
ten to the directory /u/target (if it exists and you have write permis- 
sion) no matter what your working directory. The second example 
simple writes the file arrow to your present working directory. 

Absolute pathnames specify the location of a file in relation to the root 
directory (/); relative pathnames are relative to the current directory. 
This must be taken into account when making a tar tape or disk. 
Backup volumes use absolute pathnames so that they can be restored 
to the proper directory. Use relative pathnames when creating a tar 
volume where absolute pathnames are unnecessary. 

Examples 



If the name of a floppy disk device is /dev/fdl, then a tar format file 
can be created on this device by entering: 

assign /dev/fd 

tar cvfk /dev/fdl 360 files 

where files are the names of files you want archived and 360 is the 
capacity of the floppy disk in kilobytes. Note that arguments to key 
letters are given in the same order as the key letters themselves, thus 
the fk key letters have corresponding arguments /dev/fdl and 360. 
Note that if a file is a directory, the contents of the directory are recur- 
sively archived. To display a listing of the archive, enter: 

tar tvf /dev/fdl 

At some later time you will likely want to extract the files from the 
archive floppy. You can do this by entering: 

tar xvf /dev/fdl 

The above command extracts all files from the archive, using the exact 
same pathnames as used when the archive was created. Because of 
this behavior, it is normally best to save archive files with relative 
pathnames rather than absolute ones, since directory permissions may 
not let you read the files into the absolute directories specified. (See 
the A flag under Options .) 
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In the above examples, the v verbose option is used simply to confirm 
the reading or writing of archive files on the screen. Also, a normal file 
could be substituted for the floppy device /dev/fdl shown in the exam- 
ples. 

Files 



/etc/default/tar 

/tmp/tar* 

Diagnostics 



Default devices, blocking and 
volume sizes, device type 



Displays an error message about bad key characters and archive 
read/write errors. 

Displays an error message if not enough memory is available to hold 
the link tables. 

Notes 



There is no way to ask for the nth occurrence of a file. 

tar does not verify the selected media type. 

The u option can be slow. 

The limit on filename length is 100 characters. 

When archiving a directory that contains subdirectories, tar will only 
access those subdirectories that are within 17 levels of nesting. Sub- 
directories at higher levels will be ignored after tar displays an error 
message. 

When using tar with a raw device, specify the block size with the b 
option as a multiple of 512 bytes. For example, to use a 9K block size, 
enter: 

tar cvfb /dev/rfdO 18 file 
Do not enter: 



tar xfF - - 
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This would imply taking two things from the standard input at the 
same time. 

Use error-free floppy disks for best results with tar. 

Standards Conformance 



tar is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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tee 

creates a tee in a pipe 

Syntax 

tee [ -i ] [ -a ] [ -u ] [ file ] ... 

Description 



tee transcribes the standard input to the standard output and makes 
copies in the files. The -i option ignores interrupts; the -a option 
causes the output to be appended to the files rather than overwriting 
them. The -u option causes the output to be unbuffered. 

Examples 



The following example illustrates the creation of temporary files at 
each stage in a pipeline: 

grep ABC I tee ABC.grep I sort I tee ABC.sort 1 more 
This example shows how to tee output to the terminal screen: 
grep ABC I tee /dev/ttyxx I sort I uniq >final.file 

Standards Conformance 

tee is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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test 

tests conditions 

Syntax 

test expr 
[expr] 

Description 

test evaluates the expression expr , and if its value is true, returns a 
zero (true) exit status; otherwise, test returns a nonzero exit status if 
there are no arguments. The following primitives are used to con- 
struct expr: 

-Y file True if file exists and is readable. 

-w file True if file exists and is writable. 

-X file True if file exists and is executable. 

-f file True if file exists and is a regular file. 

-d file True if file exists and is a directory. 

-c file True if file exists and is a character special file. 

-b file True if file exists and is a block special file. 

-u file True if file exists and its set-user-ID bit is set. 

-gfile True if file exists and its set-group-ID bit is set. 

-kfile True if file exists and its sticky bit is set. 

-s file True if file exists and has a size greater than zero. 

-t [fiildes ] True if the open file whose file descriptor number is 

fildes ( 1 by default) is associated with a terminal de- 
vice. 

-z si True if the length of string si is zero. 

-n si True if the length of string si is nonzero. 
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TEST (C) 


si =s2 


True if strings si and s2 are identical. 


si l=s2 


True if strings si and s2 are not identical. 


si 


True if si is not the null string. 


nl -eq n2 


True if the integers nl and n2 are algebraically equal. 
Any of the comparisons -ne, -gt, -ge, -It, and -le may 
be used in place of -eq. 


These primaries may be combined with the following operators: 


f 


Unary negation operator 


-a 


Binary and operator 


-0 


Binary or operator (-a has higher precedence than 
-o) 


( expr ) 


Parentheses for grouping 



Notice that all the operators and flags are separate arguments to test. 
Notice also, that parentheses are meaningful to the shell and, there- 
fore, must be escaped. 

See Also 

find(C), sh(C) 

Warning 



In the second form of the command (i.e., the one that uses [ ], rather 
than the word test), the square brackets must be delimited by blanks. 

Standards Conformance 



test is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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tic 

terminfo compiler 

Syntax 

tic [-V [n\ [-p permlist] ] file ... 

Description 



tic translates terminfo files from the source format into the compiled 
format. The results are placed in the directory /usr/lib/terminfo. 

The -V (verbose) option causes tic to output trace information showing 
its progress. If the optional digit n is appended, the level of verbosity 
can be increased. 

The -p option directs tic to create a permissions file permlist for use 
with fixperm(ADM). 

tic compiles all terminfo descriptions in the given files. When a use= 
field is discovered, tic first searches the current file and then the mas- 
ter file ./terminfo.src. 

If the environment variable TERMINFO is set, the results are placed 
there instead of /usr/lib/terminfo. 

Some limitations: the total size of a description cannot exceed 4096 
bytes; the name field cannot exceed 128 bytes. 

Files 



/usr/lib/terminfo/*/* -Compiled terminal capability database. 

See Also 



terminfo(M), terminfo(S), terminfo(F) 

Standards Conformance 



tic is conformant with; 

AT&T SVID Issue 2, Select Code 307-127. 
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time 

times a command 

Syntax 

time command 

Description 



The given command is executed; after it is complete, time prints the 
elapsed time during the command, the time spent in the system, and 
the time spent in execution of the command. Times are reported in 
seconds. 

The times are printed on the standard error. 

See Also 



times(S) 

Standards Conformance 



time is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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touch 

updates access and modification times of a file 
Syntax 

touch [ -amc ] [ mmddhhmm[yy] ] files 

Description 



touch causes the access and modification times of each argument to 
be updated. If no time is specified (see date{C)) the current time is 
used. If a new file is created using touch, the modification and access 
times can be set to any time. However, the creation time is automati- 
cally set to the current time at the time of creation, and cannot be 
changed. The first mm refers to the month, dd refers to the day, hh 
refers to the hour, the second mm refers to the minute, and yy refers to 
the year. The -a and -m options cause touch to update only the access 
or modification times respectively (default is -am). The -c option 
silently prevents touch from creating the file if it did not previously 
exist. 

The return code from touch is the number of files for which the times 
could not be successfully modified (including files that did not exist 
and were not created). 

See Also 



date(C), utime(S) 

Standards Conformance 



touch is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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tput 

queries the terminfo database 
Syntax 



tput [ -litype ] attribute 

Description 



The command tput uses the terminfo database to make the values of 
terminal-dependent attributes available to the shell, tput outputs a 
string if the terminal attribute is of type string, or an integer if the 
attribute is of type integer. If the attribute is of type Boolean, tput 
simply sets the exit code (0 for true if the terminal has the capability, 
1 for false if it does not) and produces no output. 

The -T flag indicates the type of the terminal. Normally this option is 
unnecessary, as the default is taken from the environment variable 
TERM. 

attribute is the terminal capability name from the terminfo database. 

Examples 



tput clear 



Echo dear-screen sequence for the current ter- 
minal. 



tput cols Print the number of columns for the current ter- 

minal. 

tput -T450 cols Print the number of columns for the 450 termi- 

nal. 

bold=’tput smsd’ 

offbold=’tput rmso’ Set the shell variables “bold” to begin stan- 
dout mode sequence and “offbold” to end 
standout mode sequence for the current termi- 
nal. This might be followed by a prompt, such 
as: 



echo ”${bold)Name: ${ offbold )Nc" 
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tput he Set exit code to indicate if the current terminal 

is a hardcopy terminal. 



Files 



/usr/lib/terminfo/*/* -Compiled terminal capability database. 

See Also 



terminfo(M), terminfo(S), tic(C), stty(C) 

Notes 



If the attrihiite is of type boolean, a value of 0 is returned for TRUE 
and a value of 1 for FALSE. 

If the attribute is of type string or integer, a value of 0 is returned upon 
successful completion. Any other value returned indicates an error. 
For example, the specification of a bad attribute (any capability name 
that is not found in the terminfo database) produces an error. 

Standards Conformance 



tput is conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 
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tr 

translates characters 

Syntax 

tr [ -cds ] [ String 1 [ string2 ] ] 

Description 



tr copies the standard input to the standard output with substitution or 
deletion of selected characters. Input characters found in stringl are 
mapped into the corresponding characters of stringl . Any combina- 
tion of the options -cds may be used: 

-c Complements the set of characters in stringl with respect to 

the universe of characters whose ASCII codes are 001 
through 377 octal 

-d Deletes all input characters in stringl 

-s Squeezes all strings of repeated output characters that are in 

stringl to single characters 

The following abbreviation conventions may be used to introduce 
ranges of characters or repeated characters into the strings: 

[a-z] Stands for the string of characters whose ASCII codes run 
from character a to character z, inclusive. 

[ 2 L*n] Stands for n repetitions of a. If the first digit of n is 0, n is 
considered octal; otherwise, n is taken to be decimal. A 
zero or missing n is taken to be huge; this facility is useful 
for padding stringl . 

The escape character \ may be used as in the shell to remove special 
meaning from any character in a string. In addition, \ followed by 1, 2, 
or 3 octal digits, stands for the character whose ASCII code is given by 
those digits. 
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The following example creates a list of all the words in filel, one per 
line in file2, where a word is taken to be a maximal string of alphabet - 
ics. The strings are quoted to protect the special characters from 
interpretation by the shell; 012 is the ASCII code for newline: 

tr -cs ”[A-Z][a-z]" <filel >file2 



See Also 



ed(C), sh(C), ascii(M) 

Notes 



Won’t handle ASCII NUL in string 1 or string ! ; always deletes NUL 
from input. 

Standards Conformance 



tr is conformant with: 

AT&T S VID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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translate 

translates files from one format to another 
Syntax 



translate option [ infile ] [ outfile ] 

Description 



translate translates files according to the options specified. Transla- 
tion is done according to the options defined below. 

format is assumed to be a file in the directory 
/usr/lib/mapchan/translate if a full pathname is not provided. 

translate uses standard input and standard output unless otherwise 
specified via the optional filename arguments. 

Options 



-ea 


From EBCDIC to ASCII. 


-ae 


From ASCII to EBCDIC. 


-fe format 


From a user defined format to EBCDIC format. 


format 


From a user defined format to ASCII format. 


-ef format 


From EBCDIC format to a user defined format. 


-Sif format 


From ASCII format to a user defined format. 


-bin 


From binary/object code to mailable ASCII 
uuencode format. 


-mb 


From mailable ASCII uuencode format to 
original binary. 



Files 



/usr/lib/mapchan/translate/* 
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See Also 



uuencode(C), dd(C), mapchan(M), sysadmsh(ADM) 

Notes 



The -bin and -mb options are, for example, used to translate execut- 
able object code format to ASCII for transfer across communications 
networks. 

The syntax for the user defined format file is the same as the syntax 
for the mapping files for mapchan(M) and trchan. 

Use dd to convert character and file formats (especially tapes) to the 
format specified. Example: 

dd if=/dev/rmtO of=outfile ibs=800 cbs=80 conv=ascii, lease 

This command reads an EBCDIC tape, blocked ten 80-byte EBCDIC 
card images per record, into the ASCII file outfile. For more informa- 
tion on conversion options, refer to dd(C) in the User's Reference. 
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true 

returns with a zero exit value 

Syntax 

true 

Description 



true does nothing except return with a zero exit value, false {C), true's 
counterpart, does nothing except return with a nonzero exit value. 
true is typically used in shell procedures such as: 

while true 
do 

command 

done 

See Also 



sh(C), false (C) 

Diagnostics 

true has exit status zero. 

Standards Conformance 



true is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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tset 

provide information to set terminal modes 
Syntax 



tset [ options ] [ type ] 

Description 



tset allows the user to set a terminal’s ERASE and KILL characters, 
and define the terminal’s type and capabilities by creating values for 
the TERM environment variable, tset initializes or resets the terminal 
with tput(C). If a type is given with the -s option, tset creates informa- 
tion for a terminal of the specified type. The type may be any type 
given in the terminfo database. If the type is not specified with the -s 
option, tset creates information for a terminal of the type defined by 
the value of the environment variable, TERM, unless the -h or -m 
option is given. If the TERM variable is defined, tset uses the 
terminfo database entry. If these options are used, tset searches the 
/etc/ttytype file for the terminal type corresponding to the current 
serial port; it then creates information for a terminal based on this 
type. If the serial port is not found in /etc/ttytype, the terminal type is 
set to unknown. 

tset displays the created information at the standard output. The infor- 
mation is in a form that can be used to set the current environment 
variables. The exact form depends on the login shell from which tset 
was invoked. The following examples illustrate how to use this infor- 
mation to change the variables. 

There are the following options: 

-e[c] 

Sets the ERASE character to c on all terminals. The default setting 
is the BACKSPACE, or CTRL-H. 

■E[c] 

Identical to the -e command except that it only operates on termi- 
nals that can BACKSPACE. 

-k[c] 

Sets the KILL character to c, defaulting to CTRL-U. 

- Prints the terminal type on the standard output. 
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-s Outputs the “setenv” commands [for csh{C)]y or “export” and 
assignment commands [for sh(l)]. The type of commands are 
determined by the user’s login shell. 

-h Forces tset to search /etc/ttytype for information and to overlook 
the environment variable, TERM. 

-S Only outputs the strings to be placed in the environment variables, 
without the shell commands printed for -S. 

-r Prints the terminal type on the diagnostic output. 

-Q Suppresses the printing of the “Erase set to” and “Kill set to” 
messages. 

-I Suppresses printing of the terminal initialization strings, e.g., 
spawns tput reset instead of tput init, 

-m[ident][test baudrate]:type 

Allows a user to specify how a given serial port is is to be mapped 
to an actual terminal type. The option applies to any serial port in 
/etc/ttytype whose type is indeterminate (e.g., dialup, plugboard, 
etc.). The type specifies the terminal type to be used, and ident 
identifies the name of the indeterminate type to be matched. If no 
ident is given, all indeterminate types are matched. The 
test baudrate defines a test to be performed on the serial port 
before the type is assigned. The baudrate must be as defined in 
sttyiC). The test may be any combination of: >, =, <, @, and !. 
If the type begins with a question mark, the user is asked if he 
really wants that type. A null response means to use that type; oth- 
erwise, another type can be entered which will be used instead. 
The question mark must be escaped to prevent filename expansion 
by the shell. If more than one -m option is given, the first correct 
mapping prevails. 

tset is most useful when included in the .login [for csh(C)] or .profile 

[for sh(C)] file executed automatically at login, with -m mapping used 

to specify the terminal type you most frequently dial in on. 

Examples 



tset gt42 

tset -mdialup\>300:adm3a -mdialup:dw2 -Qr -e# 

tset -m dial:ti733 -m plug:\?hp2621 -m unknown:\? -e -k"U 

To use the information created by the -s option for the Bourne shell, 
(sh), repeat these commands: 
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tset -s ... > /tmp/tset$$ 

/tmp/tset$$ 
rm /tmp/tset$$ 

To use the information created for csh, use: 

set noglob 

set term=('tset -S ....') 
setenv term $term[l] 
unset term 
unset noglob 



Files 



/etc/ttytype Port name to terminal type map database 

/usr/lib/terminfo/* Terminal capability database 

See Also 



stty(C), termio(M), tput(C), tty(M), terminfo(F) 

Credit 



This utility was developed at the University of California at Berkeley 
and is used with permission. 
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tty 

gets the terminal’s name 

Syntax 

tty [ -s ] 

Description 



The tty command prints the pathname of the user’s terminal on the 
standard output. The -s option inhibits printing, allowing you to test 
just the exit code. 

Exit Codes 



0 if the standard input is a terminal, 1 otherwise. 

Diagnostics 



not a tty If the standard input is not a terminal and -s is not 
specified 

Standards Conformance 



tty is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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umask 

sets file-creation mode mask 

Syntax 



umask [ 000 ] 

Description 



The user file-creation mode mask is set to 000. The three octal digits 
refer to read/write/execute permissions for owner, group, and others, 
respectively. Only the low-order 9 bits of cmask and the file mode 
creation mask are used. The value of each specified digit is “sub- 
tracted” from the corresponding “digit” specified by the system for 
the creation of any file (see umask(S) or creat(S)). This is actually a 
binary masking operation, and thus the name “umask”. In general, 
binary ones remove a given permission, and zeros have no effect at 
all. For example, umask 022 removes group and others write permis- 
sion (files normally created with mode 111 become mode 755 ; files 
created with mode 666 become mode 644). 

If 000 is omitted, the current value of the mask is printed. 

umask is recognized and executed by the shell. By default, login 
shells have a umask of 022. 

umask is built in to csh and sh. 

See Also 



chmod(C), csh(C), sh(C), chmod(S), creat(S), umask(S) 

Standards Conformance 



umask is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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uname 

prints the name of the current system 
Syntax 



uname [ -snrvma ] 
uname [ -S system name ] 

Description 



The uname command prints the current system name of the Altos 
UNIX System V system on the standard output file. It is mainly useful 
to determine which system you are using. The options cause selected 
information returned by uname {S) to be printed: 

-s print system name (default). 

-n print nodename (the nodename is the name by which the system 
is known to a communications network). 

-r print the operating system release. 

-V print the operating system version. 

-m print the machine hardware name. 

-a print all the above information. 

On your computer, the system name and the nodename may be 
changed by specifying a system name argument to the -S option. The 
system name argument is restricted to 8 characters. Only the super- 
user is allowed this capability. 

See Also 



uname(S) 

Standards Conformance 



uname is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 



March 11, 1990 



UNAME~1 








UNIQ (C) 



UNIQ (C) 



uniq 

reports repeated lines in a file 

Syntax 

uniq [ -udc [ +n ] [ -n ] ] [ input [ output ] ] 

Description 



uniq reads the input file and compares adjacent lines. In the normal 
case, the second and succeeding copies of repeated lines are removed; 
the remainder is written on the output file. Input and output should 
always be different. Note that repeated lines must be adjacent in order 
to be found; see sort{C). If the -u flag is used, just the lines that are 
not repeated in the original file are output. The -d option specifies 
that one copy of just the repeated lines is to be written. The normal 
mode output is the union of the -u and -d mode outputs. 

The -c option supersedes -u and -d and generates an output report in 
default style but with each line preceded by a count of the number of 
times it occurred. 

The n arguments specify skipping an initial portion of each line in the 
comparison: 

-« The first n fields together with any blanks before each are 

ignored. A field is defined as a string of nonspace, nontab 
characters separated by tabs and spaces from its neighbors. 

+n The first n characters are ignored. Fields are skipped before 
characters. 

See Also 



comm(C), sort(C) 

Standards Conformance 



uniq is conformant with: 

AT&TSVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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units 

converts units 

Syntax 

units 

Description 



units converts quantities expressed in various standard scales to their 
equivalents in other scales. It works interactively in this fashion: 

You have: inch 
You want: cm 

* 2.540000e+00 
/ 3.937008e-01 

A quantity is specified as a multiplicative combination of units 
optionally preceded by a numeric multiplier. Powers are indicated by 
suffixed positive integers, division is shown by the usual sign: 

You have: 15 lbs force/in2 
You want: atm 

* 1.020689e+00 
/ 9,797299e-01 

units only does multiplicative scale changes; thus it can convert Kel- 
vin to Rankine, but not Centigrade to Fahrenheit. Most familiar units, 
abbreviations, and metric prefixes are recognized, as well as the fol- 
lowing: 

pi Ratio of circumference to diameter 

c Speed of light 

e Charge on an electron 

g Acceleration of gravity 

force Same as g 
mole 

Avogadro’s number 
water 

Pressure head per unit height of water 
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au Astronomical unit 

Pound is not recognized as a unit of mass; lb is. Compound names are 
run together, (e.g. lightyear). British units that differ from their US 
counterparts are prefixed with “br”. For a complete list of units, 
enter: 

cat /usrAib/unittab 

Files 



/usr/lib/unittab 
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uptime 

displays information about system activity 

Syntax 

uptime 

Description 



uptime prints the current time of day, the length of time the system has 
been up, and the number of users logged onto the system. On systems 
that maintain the necessary data, load averages are also shown. Load 
averages are the number of processes in the run queue averaged over 
1, 5, and 15 minutes. All of this information is also contained in the 
first line of the w(C) command. 

See Aiso 



w(C) 
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usemouse 

maps mouse input to keystrokes for use with non- 
mouse based programs 

Syntax 



usemouse [ -f conffile ] [ -t type ] [ -h horiz_sens ] [ -v vert_sens ] 
[ -c cmd ] [ -b ] parameters 

Description 



This Utility allows you to use a mouse with any program that would 
otherwise accept only keyboard input. 

For example, you can use a mouse with v/(C) to move the cursor 
around the screen and generate your most commonly used vi com- 
mands. The usemouse(C) command translates mouse input into spe- 
cific keystrokes required by a program. You can use any of several 
predefined mouse keystroke sets (called maps) that correspond to dif- 
ferent popular programs. You can also define your own maps with 
keystrokes that match different mouse movements and mouse buttons. 

Options 



The options are: 

-f conffile 

The -f flag may be used to select an alternate configuration file. 
The alternate configuration file, conffile, should use the format of 
/etc/default/usemouse and be entered as an absolute pathname on 
the command line. For example: 

usemouse -f /u/daniel/mouseconf 

is the correct form to specify an alternate configuration file. The -f 
and -t flags are mutually exclusive. 

-t type 

The -t flag may be used to select a predefined configuration file. 
type can be the name of any file in /usr/lib/mouse, such as vi, 
rogue, or any others the system administrator chooses to place 
there. These files are identical in format to /etc/default/usemouse. 

-h horiz_sens 

Defines the horizontal sensitivity. Horizontal mouse movements 
smaller than this threshold are ignored. Mouse movements that are 
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multiples of this value generate multiple strings. The sensitivity 
defaults to 5 units. The minimum value is 1 unit, and the max- 
imum is 100 units. The lower the value, the more sensitive your 
mouse is to motion. Note that setting a high value may cause your 
mouse to behave as though it is not functioning, due to the large 
motion required to generate a signal. 

-v vert_sens 

Defines the vertical sensitivity. Vertical mouse movements 
smaller than this threshold are ignored. Mouse movements that are 
multiples of this value generate multiple strings. The sensitivity 
defaults to 5 units. The minimum value is 1 unit, and the max- 
imum is 100 units. The lower the value, the more sensitive your 
mouse is to motion. Note that setting a high value may cause your 
mouse to behave as though it is not functioning, due to the large 
motion required to generate a signal. 

-c cmd 

This option selects a command for usemouse to run. This defaults 
to the shell specified in the SHELL environment variable. If 
SHELL is unspecified, /bin/sh is used. Note that the command 
given with this flag can contain blank spaces if the entire command 
is placed within double quotes. For example: 

usemouse -c “vi /etc/termcap” 

is valid. 

-b Suppresses bell ("G) for the duration of mouse usage. Useful with 
v/(C). 



parameters 

These are name= value pairs indicating what ASCII string to insert 
into the tty input stream, when the given event is received. Valid 
parameters include: 



Tbu=string 


String to 


Thd=string 


String to 


mbu=string 


String to 


mbd=string 


String to 


\bu=string 


String to 


\bd=string 


String to 


n=string 


String to 


li=string 


String to 


up=string 


String to 


dn=string 


String to 


ul=string 


String to 


uT=string 


String to 



generate on right button up 
generate on right button down 
generate on middle button up 
generate on middle button down 
generate on left button up 
generate on left button down 
generate on mouse right 
generate on mouse left 
generate on mouse up 
generate on mouse down 
generate on mouse up-left 
generate on mouse up-right 
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dT=string 

d\=string 

hsens=nwwi 

vsens=nwm 

bc\ls=yes/no 



String to generate on mouse down-left 
String to generate on mouse down-right 
Sensitivity to horizontal motion 
Sensitivity to vertical motion 
Whether to remove "G characters 



Parameters may be specified in any order. They may contain octal 
escapes. They may be quoted with single or double quotes if they con- 
tain blank spaces. Any parameters may be omitted and their value, if 
any, is taken from the configuration file. 



The usemouse(C) Command 

To start using the mouse with a text program, enter the command: 
usemouse 

This command sets the mouse for use with the default map, which is 
found in /etc/default/mouse. Alternate map files can be found in the 
directory /usr/lib/mouse. You can create your own alternate map files 
and place them in this directory or in your own custom map file direc- 
tory. The default map file has the following values: 



Mouse 


Keystroke 


Left Button 


vi top of file (IG) command 


Middle Button 


vi delete character (x) command 


Right Button 


vi bottom of file (G) command 


Up 


Up Arrow Key 


Down 


Down Arrow Key 


Left 


Left Arrow Key 


Right 


Right Arrow Key 


Up and Left 


not defined 


Up and Right 


not defined 


Down and Left 


not defined 


Down and Right 


not defined 


Bells 


no 



Invoking the usemouse command without specifying any options 
makes the mouse ready for use with a wide variety of programs or 
applications. Invoking usemouse with no options causes the mouse to 
use the default keystroke map. Invoking the mouse in this way creates 
a new command shell. You can continue to use the mouse for the dura- 
tion of the shell. To terminate usemouse, simply enter Ctrl-D. 

You can also invoke usemouse for the duration of a specific command: 

usemouse -c command 
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This puts you in the program specified by command using the mouse. 
When you leave the program, mouse input is terminated. 



Using the Mouse with Specific Programs 

You can use any of several predefined maps that are set up specifically 
for use with different programs. (These maps are found in 
/usr/lib/mouse.) For example: 

usemouse -t vi 

This invokes the v/-specific map, which includes mapping the tradi- 
tional h-j-k-1 direction keys to the mouse movements. The terminal 
bell is automatically silenced by the vi map entry bells=no. This is 
done to prevent the bell being activated continuously when the user 
generates a spurious command with the mouse. (There is also a -b 
option that can be used on the usemouse command line to do the same 
thing.) 

You can combine a command with a selected map file by putting both 
on the command line. For example: 

usemouse -t vi -c \i filename 

This invokes the vi map along with the command; when you quit out 
of vi the mouse disengages. 



Setting Up Abbreviated (Aliased) Mouse Commands 

If you plan to use the mouse frequently, you can substitute short, easy 
to use commands that will call up the longer command lines. This is 
known as command aliasing. For more information on command alias- 
ing, consult the section “Using Aliases” in the “C-Shell” chapter of 
the User's Guide. 

Specifying Map keystrokes on the Command Line 

You can also specify the characters to be generated by mouse motions 
on the usemouse command line. You can specify button actions or 
motion actions to supplement or replace a definition from a map file. 
For example, assume you want to use the default usemouse file, but 
you want to redefine the middle mouse button mbd (middle button 
down) as the vi “i” (insert) instead of the “x” (delete character) com- 
mand. The following command line does this: 

usemouse -c vi mbd=i 

The mouse operations are defined by a series of acronyms that are the 
same as used in the actual map file: 
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Parameter 


Mouse Operation 


Default 


rbu 


right button up 


not used 


rbd 


right button down 


IG 


mbu 


middle button up 


not used 


mbd 


middle button down 


X 


Ibu 


left button up 


not used 


Ibd 


left button down 


G 


ul 


mouse up-left 


\033[A\033[C 


ur 


mouse up-right 


\033[A\033[D 


dr 


mouse down-left 


\033[B\033[C 


dl 


mouse down-right 


\033[B\033[D 


It 


mouse right 


\033[C 


It 


mouse left 


\033[D 


up 


mouse up 


\033[A 


dn 


mouse down 


\033[B 


hsens 


horiz. sensitivity 


5 


vsens 


vert, sensitivity 


5 



Creating Customized Maps 

You can create your own personal map files for use with the mouse. 
The easiest way to do this is to copy the default map in 
/etc/default/usemouse and edit it. You can use quoted strings or the 
octal sequences found in the ascii(M) page. The mouse 
direction/button parameters are defined in the usemouse table above. 
For example, after placing a customized file, mine, in your home 
directory, you would invoke the following command to use it with the 
program prog: 

usemouse -f mine -c prog 
How usemouse Works 

usemouse merges data from a mouse into the input stream of a tty. The 
mouse data is translated to arrow keys or any other arbitrary ASCII 
strings. Mouse movements up, down, left right, up-left, up-right, 
down-left, and down-right, as well as individual up and down button 
transitions, are programmable. This permits the mouse to be used 
with programs that are not designed to accept mouse input. 

By default, the usemouse utility gets value configurations from the file 
/etc/default/usemouse . 

After running the utility, provided a mouse is available, the user will 
be running a command with mouse motions and button events 
translated to ASCII strings and merged into their tty input stream. By 
default, the command is a shell. 
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/dev/mouse 

/dev/mouse/bus [0- 1 ] 

/dev/mouse/vpix[0- 1 ] 

/dev/mouse/microsoft_ser 

/dev/mouse/logitech_ser 

/dev/mouse/mousesys_ser 

/dev/mouse/ttyp[0-7] 

/de v/mouse/ptyp[0-7 ] 
/etc/default/usemou se 
/usr/lib/event/devices 
/usr/lib/event/ttys 
/usr/lib/mouse/* 

See Also 



Directory for mouse-related special device files. 
Bus mouse device files, 
vpix-mouse device files. 

Microsoft serial mouse device files. 

Logitech serial mouse device files. 

Mousesys serial mouse device files. 

Special pseudo-tty files for mouse input. 

Special pseudo-tty files for mouse input. 

Default map file for mouse-generated characters. 
File containing device information for mice. 

File listing ttys eligible to use mice. 

Alternate map files for mice. 



mouse(HW) 
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UUCP, uulog, uuname 

UNIX-to-UNIX system copy 

Syntax 



UUCP [ options ] source-files destination-file 

uulog [ options ] -s system 

uulog [ options ] system 

uulog [ options ] -f system 

uuname [ -1 ] [ -c ] 

Description 



UUCP copies files named by the source-file arguments to the 
destination-file argument. A file name may be a path name on your 
machine, or may have the form: 

system-name Ipath-name 

where system-name is taken from a list of system names that uucp 
knows about. The system-name may also be a list of names such as 

system-name! system-name! . .. ! system-name! path-name 

in which case an attempt is made to send the file via the specified 
route, to the destination. See Warnings and Notes below for restric- 
tions. Care should be taken to ensure that intermediate nodes in the 
route are willing to forward information (see Warnings below for re- 
strictions). 

The shell metacharacters ?, * and [ . . . ] appearing in path-name will 
be expanded on the appropriate system. 

Path names may be one of: 

(1) a full path name; 

(2) a path name preceded by 'user where user is a login name 
on the specified system and is replaced by that user’s login 
directory; 

(3) a path name preceded by 'Idestination where destination is 
appended to /usr/spool/uucppublic; (NOTE: This destina- 
tion will be treated as a file name unless more than one file is 
being transferred by this request or the destination is already 
a directory. To ensure that it is a directory, follow the desti- 
nation with a T. For example 7dan/ as the destination will 
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make the directory /usr/spool/uucppublic/dan if it does not 
exist and put the requested file(s) in that directory). 

(4) anything else is prefixed by the current directory. 

If the result is an erroneous path name for the remote system the copy 
will fail. If the destination-file is a directory, the last part of the 
source- file name is used. 

UUCP preserves execute permissions across the transmission and gives 
0666 read and write permissions (see chmodiS)). 

The following options are interpreted by uucp : 

-c Do not copy local file to the spool directory for transfer to 

the remote machine (default). 

-C Force the copy of local files to the spool directory for 

transfer. 

-d Make all necessary directories for the file copy (default). 

-f Do not make intermediate directories for the file copy. 

aggrade Grade is a single letter/number; lower ascii sequence 

characters will cause the job to be transmitted earlier dur- 
ing a particular conversation. 

-j Output the job identification ASCII string on the standard 

output. This job identification can be used by uustat to 
obtain the status or terminate a job. 

-m Send mail to the requester when the copy is completed. 

-nuser Notify user on the remote system that a file was sent. 

-r Do not start the file transfer, just queue the job. 

-sfile Report status of the transfer to file. Note that the file must 

be a full path name. 

•xdebugjevel 

Produce debugging output on standard output. The 
debugjevel is a number between 0 and 9; higher numbers 
give more detailed information. 

uulog queries a log file of uucp or uuxqt transactions in a file 
/usr/spool/uucp/Xog/uucico/5^y5^^^w, or 

/usr/spool/uucp/.Log/uuxqt/^y^r^m. 
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The options cause uulog to print logging information: 

-ssys Print information about file transfer work involving sys- 

tem sys. 

-f system Does a “tail -f’ of the file transfer log for system, (You 

must press DELETE or BREAK to exit this function.) 
Other options used in conjunction with the above: 

-X Look in the uuxqt log file for the given system, instead of 

the uucico log file (default). 

‘number Indicates that a “tail” command of number lines should 
be executed. 

uuname lists the names of systems known to uucp. The -c option 
returns the names of systems known to cu. (The two lists are the 
same, unless your machine is using different Systems files for cu and 
uucp. See the Sys files file.) The -1 option returns the local system 
name. 

Files 



/usr/spool/uucp spool directories 

/usr/spool/uucppublic/*public directory for receiving and 
sending (/usr/spool/uucppublic) 
/usr/lib/uucp/* other data and program files 

See Also 



mail(C), uustat(C), uux(C), uuxqt(C), chmod(S) 

Warnings 



The domain of remotely accessible files can (and for obvious security 
reasons, usually should) be severely restricted. You will very likely 
not be able to fetch files by path name; ask a responsible person on the 
remote system to send them to you. For the same reasons you will 
probably not be able to send files to arbitrary path names. As distrib- 
uted, the remotely accessible files are those whose names begin 
/usr/spool/uucppublic (equivalent to 7). 

All files received by uucp will be owned by uucp . The -m option will 
only work sending files or receiving a single file. Receiving multiple 
files specified by special shell characters ? * will not activate 
the -m option. 
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The forwarding of files through other systems may not be compatible 
with the previous version of uucp. If forwarding is used, all systems in 
the route must have the same version of uucp. 

Notes 



Protected files and files that are in protected directories that are owned 
by the requester can be sent by uucp. However, if the requester is 
root, and the directory is not searchable by “other” or the file is not 
readable by “other,” the request will fail. 

Standards Conformance 



uucp, uulog and uuname are conformant with: 

AT&TSVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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uuencode, uudecode 

encode/decode a binary file for transmission via mail 

Syntax 



uuencode [ source ] remotedest I mail sysl!sys2!..! decode 
uudecode [ file ] 

Description 



uuencode and uudecode are used to send a binary file via uucp (or 
other) mail. This combination can be used over indirect mail links. 

uuencode takes the named source file (default standard input) and pro- 
duces an encoded version on the standard output. The encoding uses 
only printing ASCII characters, and includes the mode of the file and 
the remotedest for recreation on the remote system. 

uudecode reads an encoded file, strips off any leading and trailing 
lines added by mailers, and recreates the original file with the speci- 
fied mode and name. 

The intent is that all mail to the user “decode” should be filtered 
through the uudecode program. This way the file is created automati- 
cally without human intervention. This is possible on the uucp net- 
work by either using sendmail or by making rmail be a link to mail 
instead of mail . In each case, an alias must be created in a master file 
to get the automatic invocation of uudecode. 

If these facilities are not available, the file can be sent to a user on the 
remote machine who can uudecode it manually. 

The encode file has an ordinary text form and can be edited by any 
text editor to change the mode or remote name. 

See Also 



uucp(C), uux(ADM), mail(C) 
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Restrictions 



The file is expanded by 35% (3 bytes become 4 plus control informa- 
tion) causing it to take longer to transmit. 

The user on the remote system who is invoking uudecode (often uucp) 
must have write permission on the specified file. 
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uustat 

UUCP status inquiry and job control 

Syntax 



uustat I -a] 

uustat i-m] 

uustat [-p] 

uustat [>q] 

uustat [ -kjobid ] 

uustat [ -rjobid J 

uustat [ -s system ] [ -uuser ] 

Description 



uustat will display the status of, or cancel, previously specified uucp 
commands, or provide general status on uucp connections to other sys- 
tems. Only one of the following options can be specified with uustat 
per command execution: 

-a Output all jobs in queue. 

-m Report the status of accessibility of all machines. 

-p Execute a “ps -flp” for all the process-ids that are in the 

lock files. 

-q List the jobs queued for each machine. If a status file 

exists for the machine, its date, time and status informa- 
tion are reported. In addition, if a number appears in () 
next to the number of C or X files, it is the age in days of 
the oldest C./X. file for that system. The Retry field 
represents the number of hours until the next possible call. 
The Count is the number of failure attempts. NOTE: for 
systems with a moderate number of outstanding jobs, this 
could take 30 seconds or more of real-time to execute. As 
an example of the output produced by the -q option: 

eagle 3C 04/07-11 :07NO DEVICES AVAILABLE 

nnh3bs3 2C 07/07-10 : 42SUCCESSFUL 

The above output tells how many command files are wait- 
ing for each system. Each command file may have zero or 
more files to be sent (zero means to call the system and 
see if work is to be done). The date and time refer to the 
previous interaction with the system followed by the 
status of the interaction. 

‘kjobid Kill the uucp request whose job identification is johid. 

The killed uucp request must belong to the person issuing 
the uustat command unless one is the super-user. 
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•Yjobid Rejuvenate jobid. The files associated with jobid are 
touched so that their modification time is set to the 
current time. This prevents the cleanup daemon from 
deleting the job until the jobs modification time reaches 
the limit imposed by the daemon. 

Either or both of the following options can be specified with uustat: 

•ssys Report the status of all uucp requests for remote system 
sys. 

•uuser Report the status of all uucp requests issued by user. 

Output for both the -s and -u options has the following format: 

eaglenOOOO 4/07-11:01:03 (POLL) 

eagleNlbd? 4/07-11:07 Seagledan522 /usr/dan/A 

eagleClbdS 4/07-11:07 Seagledan59 D.3b2al2ce4924 

4/07-11:07 Seagledanrmail mike 

With the above two options, the first field is the jobid of the job. This 
is followed by the date/time. The next field is either an ’S’ or ’R’ 
depending on whether the job is to send or request a file. This is fol- 
lowed by the user-id of the user who queued the job. The next field 
contains the size of the file, or in the case of a remote execution ( 
rmail - the command used for remote mail), the name of the command. 
When the size appears in this field, the file name is also given. This 
can either be the name given by the user or an internal name (e.g., 
D.3b2alce4924) that is created for data files associated with remote 
executions (rmail in this example). 

When no options are given, uustat outputs the status of all uucp 
requests issued by the current user. 

Files 



/usr/spool/uucp/* spool directories 

See Also 

uucp(C) 

Standards Conformance 



uustat is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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uuto, uupick 

public UNIX-to-UNIX system file copy 

Syntax 



uuto [ options ] source-files destination 
uupick [ -s system ] 

Description 



uuto sends source-files to destination, uuto uses the uucp(C) facility 
to send files, while it allows the local system to control the file access. 
A source-file name is a path name on your machine. Destination has 
the form: 

system! 

where system is taken from a list of system names that uucp knows 
about (see uuname). User is the login name of someone on the speci- 
fied system. 

Two options are available: 

-p Copy the source file into the spool directory before transmis- 

sion. 

-m Send mail to the sender when the copy is complete. 

The files (or sub- trees if directories are specified) are sent to PUBDIR 
on system, where PUBDIR is a public directory defined in the uucp 
source. By default this directory is /usr/spool/uucppublic. Specifical- 
ly the files are sent to 

PUBDIR/receive/w.y^r/my^y^'r^m/files. 

The destined recipient is notified by mailiC) of the arrival of files. 

uupick accepts or rejects the files transmitted to the user. Specifical- 
ly, uupick searches PUBDIR for files destined for the user. For each 
entry (file or directory) found, the following message is printed on the 
standard output: 

from system: [file file-name] [dir dirname] ? 

uupick then reads a line from the standard input to determine the 
disposition of the file: 
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<new-line> Go on to next entry. 

d Delete the entry. 

m [ dir ] Move the entry to named directory dir. If dir is not 

specified as a complete path name (in which 
$HOME is legitimate), a destination relative to the 
current directory is assumed. If no destination is 
given, the default is the current directory. 

a [ dir ] Same as m except moving all the files sent from 

system . 

p Print the content of the file. 

q Stop. 

EOT (control-d) Same as q. 

Icommand Escape to the shell to do command. 

* Print a command summary. 

unpick invoked with the -ssystem option will only search the PUBDIR 

for files sent from system . 



Files 

PUBDIR /usr/spool/uucppublic public directory 

See Also 

mail(C), uucp(C), uustat(C), uux(C), uuclean(ADM) 

Warnings 

In order to send files that begin with a dot (e.g., .profile) the files must 
by qualified with a dot. For example: .profile, .prof*, .profil? are 
correct; whereas *prof*, ?profile are incorrect. 

Standards Conformance 

unpick and uuto are conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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UUX 

UNIX-to-UNIX system command execution 

Syntax 

UUX [ options ] command-string 

Description 



UUX will gather zero or more files from various systems, execute a 
command on a specified system and then send standard output to a file 
on a specified system. 

NOTE: For security reasons, most installations limit the list of com- 
mands executable on behalf of an incoming request from uux, permit- 
ting only the receipt of mail (see mail{C)). (Remote execution per- 
missions are defined in /usr/lib/uucp/Permissions.) 

The command-string is made up of one or more arguments that look 
like a shell command line, except that the command and file names 
may t>e prefixed by system-name A null system-name is interpreted 
as the local system. 

File names may be one of 

(1) a full path name; 

(2) a path name preceded by ^xxx where xxx is a login name on 
the specified system and is replaced by that user’s login 
directory; 

(3) anything else is prefixed by the current directory. 

As an example, the command 

UUX "Idiff usg!/usr/dan/filel pwba!/a4/dan/file2 > !7dan/file.difiT 

will get the filel and file! files from the “usg” and “pwba” machines, 
execute a diff(C) command and put the results in file. diff in the local 
PUBDIR/dan/ directory. 

Any special shell characters such as <>;| should be quoted either by 
quoting the entire command-strings or quoting the special characters 
as individual arguments. 
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UUX will attempt to get all files to the execution system. For files that 
are output files, the file name must be escaped using parentheses. For 
example, the command 

UUX a!cut -fl b!/usr/file\(c!/usr/file\) 

gets /usr/file from system “b” and sends it to system “a’\ performs a 
cut command on that file and sends the result of the cut command to 
system “c”. 

UUX will notify you if the requested command on the remote system 
was disallowed. This notification can be turned off by the -n option. 
The response comes by remote mail from the remote machine. 

The following options are interpreted by uux: 

The standard input to uux is made the standard input to 
the command- string . 

-mame Use name as the user identification replacing the initiator 
user-id. (Notification will be returned to the user.) 

-b Return whatever standard input was provided to the uux 

command if the exit status is non-zero. 

-c Do not copy local file to the spool directory for transfer to 

the remote machine (default). 

-C Force the copy of local files to the spool directory for 

transfer. 

•ggrade Grade is a single letter/number; lower ASCII sequence 
characters will cause the job to be transmitted earlier dur- 
ing a particular conversation. 

-j Output the jobid ASCII string on the standard output 

which is the job identification. This job identification can 
be used by uustat to obtain the status or terminate a job. 

-n Do not notify the user if the command fails. 

-p Same as -: The standard input to uux is made the standard 

input to the command-string . 

-r Do not start the file transfer, just queue the job. 

‘Sfde Report status of the transfer in file. 

‘Xdebug level 

Produce debugging output on the standard output. The 
debug jevel is a number between 0 and 9; higher numbers 
give more detailed information. 
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-z Send success notification to the user. 



Files 



/usr/spool/uucp/* spool directories 

/usr/lib/uucp/Permissions remote execution permissions 

/usr/lib/uucp/* other data and programs 

See Also 



mail(C), uucp(C), uustat(C) 

Warnings 



Only the first command of a shell pipeline may have a system-name 
All other commands are executed on the system of the first command. 
The use of the shell metacharacter * will probably not do what you 
want it to do. The shell tokens « and » are not implemented. 

The execution of commands on remote systems takes place in an exe- 
cution directory known to the uucp system. All files required for the 
execution will be put into this directory unless they already reside on 
that machine. Therefore, the simple file name (without path or ma- 
chine reference) must be unique within the uux request. The follow- 
ing command will NOT work: 

uux "aldiff b!/usr/dan/xyz c!/usr/dan/xyz > Ixyz.difif’ 
but the command 

uux "aldifif a!/usr/dan/xyz c!/usr/dan/xyz > Ixyz.difif’ 
will work. (If a permitted command.) 

Notes 



Protected files and files that are in protected directories that are owned 
by the requester can be sent in commands using uux. However, if the 
requester is root, and the directory is not searchable by “other,” the 
request will fail. 

Standards Conformance 



UUX is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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VC 

version control 

Syntax 



VC [-a] [-t] [-cchar] [-s] [keyword=value ... keyword=value] 

Description 



The VC command copies lines from the standard input to the standard 
output under control of its arguments and control statements encoun- 
tered in the standard input. In the process of performing the copy 
operation, user declared keywords may be replaced by their string 
value when they appear in plain text and/or control statements. 

The copying of lines from the standard input to the standard output is 
conditional, based on tests (in control statements) of keyword values 
specified in control statements or as vc command arguments. 

A control statement is a single line beginning with a control character, 
except as modified by the -t keyletter (see below). The default control 
character is colon (:), except as modified by the -c keyletter (see 
below). Input lines beginning with a backslash (\) followed by a con- 
trol character are not control lines and are copied to the standard out- 
put with the backslash removed. Lines beginning with a backslash 
followed by a non-control character are copied in their entirety. 

A keyword is composed of 9 or fewer alphanumerics; the first must be 
alphabetic. A value is any ASCII string that can be created with 
ed{C)\ a numeric value is an unsigned string of digits. Keyword 
values may not contain blanks or tabs. 

Replacement of keywords by values is done whenever a keyword sur- 
rounded by control characters is encountered on a version control 
statement. The -a keyletter (see below) forces replacement of key- 
words in all lines of text. An uninterpreted control character may be 
included in a value by preceding it with \. If a literal \ is desired, then 
it too must be preceded by \. 

Keyletter Arguments 

-a Forces replacement of keywords surrounded by control char- 
acters with their assigned value in all text lines and not just in 
VC statements. 
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-t All characters from the beginning of a line up to and including 
the first tab character are ignored for the purpose of detecting 
a control statement. If one is found, all characters up to and 
including the tab are discarded. 

-Qchar Specifies a control character to be used in place of the colon. 

-s Silences warning messages (not error) that are normally 
printed on the diagnostic output. 

Version Control Statements 

:dcl keyword[, . . keyword] 

Used to declare keywords. All keywords must be declared. 

:asg keyword=value 

Used to assign values to keywords. An asg statement overrides 
the assignment for the corresponding keyword on the vc com- 
mand line and all previous asg’s for that keyword. Keywords 
declared, but not assigned values have null values. 

:if condition 



:end 

Used to skip lines of the standard input. If the condition is true, 
all lines between the if statement and the matching end state- 
ment are copied to the standard output. If the condition is false, 
all intervening lines are discarded, including control statements. 
Note that intervening if statements and matching end state- 
ments are recognized solely for the purpose of maintaining the 
proper if-end matching. 

The syntax of a condition is: 

<cond> ::= [ ’’not" ] <or> 

<or> ::= <and> I <and> 'T <or> 

<and> ::= <exp> I <exp> <and> 

<exp> ::= <or> ")" I <value> <op> <value> 

<op> ::= I "!=•• I V" I 

<value> :;= <arbitrary ASCII string> I <numeric string> 

The available operators and their meanings are: 

= equal 

!= not equal 

& and 

I or 

> greater than 

< less than 

( ) used for logical groupings 
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not may only occur immediately after the if, and when 
present, inverts the value of the entire condition 

The > and < operate only on unsigned integer values (e.g., : 012 
> 12 is false). All other operators take strings as arguments 
(e.g., : 012 != 12 is true). The precedence of the operators (from 
highest to lowest) is: 

= != >< all of equal precedence 
& 

I 

Parentheses may be used to alter the order of precedence. 

Values must be separated from operators or parentheses by at 
least one blank or tab. 

::text Used for keyword replacement on lines that are copied to the 
standard output. The two leading control characters are 
removed, and keywords surrounded by control characters in text 
are replaced by their value before the line is copied to the output 
file. This action is independent of the -a keyletter. 

:on 

toff Turn on or off keyword replacement on all lines. 

:ctl char 

Change the control character to char, 
tmsg message 

Prints the given message on the diagnostic output, 
terr message 

Prints the given message followed by: 

ERROR: err statement on line . . . (915) 

on the diagnostic output, vc halts execution and returns an exit 
code of 1. 

See Also 



ed(C) 

Diagnostics 



0 - normal 

1 - any error 
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Vi, view, vedit 



invokes a screen-oriented display editor 


Syntax 




vi [ -option ... ] 


[ command ... ] [ filename ... ] 


view [ -option . 


... ] [ command ... ] [ filename ... ] 


vedit [ -option 


... ] [ command ... ] [ filename ... ] 


Description 





Vi offers a powerful set of text editing operations based on a set of 
mnemonic commands. Most commands are single keystrokes that 
perform simple editing functions, vi displays a full screen “window” 
into the file you are editing. The contents of this window can be 
changed quickly and easily within vi. While editing, visual feedback 
is provided (the name vi itself is short for “visual’ ’ ). 

The view command is the same as vi except that the read-only option 
(-R) is set automatically. The file cannot be changed with view . 

The vedit command is the same as vi except for differences in the 
option settings, vedit uses novice mode, turns off the magic option, 
sets the option report=l and turns on the options showmode and 
redraw. 

The showmode option informs the vedit user, in a message in the 
lower right hand comer of the screen, which mode is being used. For 
instance after the ESC-i command is used, the message reads 
“INSERT MODE”. 

Note that you can not set the novice option from within vi or ex. If 
you want to use the novice option you must use the vedit utility. (It is 
possible to set the nonovice option from within vedit.) 

vi and the line editor ex are one and the same editor: the names vi and 
ex identify a particular user interface rather than any underlying func- 
tional difference. The differences in user interface, however, are quite 
striking, ex is a powerful line-oriented editor, similar to the editor ed. 
However, in both ex and ed, visual updating of the terminal screen is 
limited, and commands are entered on a command line, vi, on the 
other hand, is a screen-oriented editor designed so that what you see 
on the screen corresponds exactly and immediately to the contents of 
the file you are editing. In the following discussion, vi commands and 
options are printed in boldface type. 
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Options available on the vi command line include: 

-X Encryption option; when used, the file will be encrypted as it is 
being written and will require an encryption key to be read, vi 
makes an educated guess to determine if a file is encrypted or not. 
See crypt (C). Also, see the Notes section at the end of this manual 
page. 

-C Encryption option; the same as -x except that vi assumes files are 
encrypted. 

-c command 

Begin editing by executing the specified editor command 
(usually a search or positioning command). 

-t tag Equivalent to an initial tag command; edits the file con- 
tainin. tag and positions the editor at its definition. 

-rfile Used in recovering after an editor or system crash, 
retrieves the last saved version of the named file. 

-1 Specific to editing LISP, this option sets the showmatch 

and lisp options. 

-L List the names of all files saved as a result of an editor or 

system crash. Files may be recovered with the -r option. 

-wn Sets the default window size to n. Useful on dialups to 

start in small windows. 

-R Sets a read-only option so that files can be viewed but not 

edited. 



The Editing Buffer 

vi performs no editing operations on the file that you name during 
invocation. Instead, it works on a copy of the file in an “editing 
buffer.” 

When you invoke vi with a single filename argument, the named file is 
copied to a temporary editing buffer. The editor remembers the name 
of the file specified at invocation, so that it can later copy the editing 
buffer back to the named file. The contents of the named file are not 
affected until the changes are copied back to the original file. 



Modes of Operation 

Within vi there are three distinct modes of operation: 
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Command Mode Within command mode, signals from the 

keyboard are interpreted as editing com- 
mands. 

Insert Mode Insert mode can be entered by typing any 

of the vi insert, append, open, substitute, 
change, or replace commands. Once in 
insert mode, letters typed at the key- 
board are inserted into the editing buffer. 

ex Escape Mode The vi and ex editors are one and the 

same editor differing mainly in their user 
interface. In vi , commands are usually 
single keystrokes. In ex, commands are 
lines of text terminated by a RETURN. 
V/ has a special “escape” command that 
gives access to many of these line- 
oriented ex commands. To use the ex 
escape mode, type a colon (:). The colon 
is echoed on the status line as a prompt 
for the ex command. An executing com- 
mand can be aborted by pressing INTER- 
RUPT. Most file manipulation com- 
mands are executed in ex escape mode 
(for example, the commands to read in a 
file and to write out the editing buffer to 
a file). 



Special Keys 

There are several special keys in vi. The following keys are used to 

edit, delimit, or abort commands and command lines. 

ESC Used to return to vi command mode or to cancel par- 

tially formed commands. 

RETURN Terminates ex commands when in ex escape mode. 
Also used to start a newline when in insert mode. 

INTERRUPT Often the same as the DEL or RUB OUT key on many 
terminals. Generates an interrupt, telling the editor to 
stop what it is doing. Used to abort any command that 
is executing. 

/ Used to specify a string to be searched for. The slash 

appears on the status line as a prompt for a search 
string. The question mark (?) works exactly like the 
slash key, except that it is used to search backward in a 
file instead of forward. 
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: The colon is a prompt for an ex command. You can 

then type in any ex command, followed by an E:SC or 
RETURN, and the given ex command is executed. 

The following characters are special in insert mode: 

BKSP Backs up the cursor one character on the current line. The 
last character typed before the BKSP is removed from the 
input buffer, but remains displayed on the screen. 

Ctrl-U Moves the cursor back to the first character of the inser- 
tion and restarts insertion. 

Ctrl-V Removes the special significance of the next typed char- 
acter. Use Ctrl-V to insert control characters. Linefeed 
and Ctrl-J cannot be inserted in the text except as newline 
characters. Ctrl-Q and Ctrl-S are trapped by the operating 
system before they are interpreted by v/, so they too can- 
not be inserted as text. 

Ctrl-W Moves the cursor back to the first character of the last 
inserted word. 

Ctrl-T During an insertion, with the autoindent option set and at 
the beginning of the current line, entering this character 
will insert shiftwidth whitespace. 

Ctrl-@ If entered as the first character of an insertion, it is 
replaced with the last text inserted, and the insertion ter- 
minates. Only 128 characters are saved from the last 
insertion. If more than 128 characters were inserted, then 
this command inserts no characters. A Ctrl-@ cannot be 
part of a file, even if quoted. 



Starting and Exiting vi 
To enter vi , enter: 

vi Edits empty editing buffer 

vi file Edits named file 

vi +123 file Goes to line 123 

vi +45 file Goes to line 45 

vi +/word file Finds first occurrence of ‘ 'word ' 

vi +/tty file Finds first occurrence of "tty' ' 
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There are several ways to exit the editor: 

ZZ The editing buffer is written to the file only if any changes were 
made. 

:x The editing buffer is written to the file only if any changes were 
made. 

:q! Cancels an editing session. The exclamation mark (!) tells vi to 
quit unconditionally. In this case, the editing buffer is not writ- 
ten out. 

vi Commands 



vi is a visual editor with a window on the file. What you see on the 
screen is v/’s notion of what the file contains. Commands do not 
cause any change to the screen until the complete command is 
entered. Most commands may take a preceding count that specifies 
repetition of the command. This count parameter is not given in the 
following command descriptions, but is implied unless overridden by 
some other prefix argument. When vi gets an improperly formatted 
command, it rings a bell. 

Cursor Movement 

The cursor movement keys allow you to move your cursor around in a 
file. Note in particular the direction keys (if available on your termi- 
nal), the H, J, K, and L cursor keys, and SPACEBAR, BKSP, Ctrl-N, and 
Ctrl-P. These three sets of keys perform identical functions. 

Forward Space - 1, SPACEBAR, or right direction key 

Syntax: 1 

SPACEBAR 
right direction key 

Function: Moves the cursor forward one character. If a count is 

given, move forward count characters. You cannot move 
past the end of the line. 

Backspace - h, BKSP, or left direction key 

Syntax: h 

BKSP 

left direction key 

Function: Moves cursor backward one character. If a count is given, 

moves backward count characters. Note that you cannot 
move past the beginning of the current line. 
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Next Line - +, RETURN, j, Ctrl-N, and LF 

Syntax: + 

RETURN 

Function: Moves the cursor down to the beginning of the next line. 

Syntax: j 

Ctrl-N 

LF 

down direction key 

Function: Moves the cursor down one line, remaining in the same 

column. Note the difference between these commands 
and the preceding set of next line commands which move 
to the beginning of the next line. 

Previous Line - k, Ctrl-P, and up direction key 

Syntax: k 

Ctrl-P 

up direction key 

Function: Moves the cursor up one line, remaining in the same 
column. If a count is given, the cursor is moved count 
lines. 

Syntax: 

Function: Moves the cursor up to the beginning of the previous line. 

If a count is given, the cursor is moved up a count lines. 

Beginning of Line - 0 and " 

Syntax: 

0 

Function: Moves the cursor to the beginning of the current line. 

Note that 0 always moves the cursor to the first character 
of the current line. The caret (") works somewhat 
differently: it moves to the first character on a line that is 
not a tab or a space. This is useful when editing files that 
have a great deal of indentation, such as program texts. 
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End of Line - $ 

Syntax: $ 

Function: Moves the cursor to the end of the current line. Note that 

the cursor resides on top of the last character on the line. 
If a count is given, the cursor is moved forward count-l 
lines to the end of the line. 

Goto Line - G 

Syntax: [linenumber]G 

Function: Moves the cursor to the beginning of the line specified by 

linenumber . If no linenumber is given, the cursor moves 
to the beginning of the last line in the file. To find the line 
number of the current line, use Ctrl-G. 

Column - 1 

Syntax: [column]] 

Function: Moves the cursor to the column in the current line given 

by column. If no column is given, the cursor is moved to 
the first column in the current line. 

Word Forward - w and W 

Syntax: w 

W 

Function: Moves the cursor forward to the beginning of the next 

word. The lowercase w command searches for a word 
defined as a string of alphanumeric characters separated 
by punctuation or whitespace (i.e., tab, newline, or space 
characters). The uppercase W command searches for a 
word defined as a string of nonwhitespace characters. 

Back Word - b and B 

Syntax: b 

B 

Function: Moves the cursor backward to the beginning of a word. 

The lowercase b command searches backward for a word 
defined as a string of alphanumeric characters separated 
by punctuation or whitespace (i.e., tab, newline, or space 
characters). The uppercase B command searches for a 
word defined as a string of non- whitespace characters. If 
the cursor is already within a word, it moves backward to 
the beginning of that word. 
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End - e and E 

Syntax: e 

E 

Function: Moves the cursor to the end of a word. The lowercase e 

command moves the cursor to the last character of a word, 
where a word is defined as a string of alphanumeric char- 
acters separated by punctuation or whitespace (i.e., tab, 
newline, or space characters). The uppercase E moves the 
cursor to the last character of a word where a word is 
defined as a string of nonwhitespace characters. If the 
cursor is already within a word, it moves to the end of that 
word. 

Sentence - ( and ) 

Syntax: ( 

) 

Function: Moves the cursor to the beginning (left parenthesis) or 

end of a sentence (right parenthesis). A sentence is 
defined as a sequence of characters ending with a period 
( .), question mark (?), or exclamation mark (!), followed 
by either two spaces or a newline. A sentence begins on 
the first nonwhitespace character following a preceding 
sentence. Sentences are also delimited by paragraph and 
section delimiters. See below. 

Paragraph - { and } 

Syntax: } 

{ 

Function: Moves the cursor to the beginning ({) or end (}) of a para- 

graph. A paragraph is defined with the paragraphs 
option. By default, paragraphs are delimited by the nroff 
macros “.IP”, “.LP”, “.P”, “.QP”, and “.bp”. Para- 
graphs also begin after empty lines. 

Section - [[ and ]] 

Syntax: ]] 

[[ 

Function: Moves the cursor to the beginning ([[) or end (]]) of a sec- 

tion. A section is defined with the sections option. By 
default, sections are delimited by the nroff macros “.NH” 
and “.SH”. Sections also start at formfeeds (Ctrl-L) and 
at lines beginning with a brace ({). 
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Match Delimiter - % 

Syntax: % 

Function: Moves the cursor to a matching delimiter, where a delim- 

iter is a parenthesis, a bracket, or a brace. This is useful 
when matching pairs of nested parentheses, brackets, and 
braces. 

Home - H 

Syntax: [offset]U 

Function: Moves the cursor to the upper left corner of the screen. 

Use this command to quickly move to the top of the 
screen. If an offset is given, the cursor is homed offset -I 
number of lines from the top of the screen. Note that the 
command “dH” deletes all lines from the current line to 
the top line shown on the screen. 

Middle Screen - M 

Syntax: M 

Function: Moves the cursor to the beginning of the screen’s middle 

line. Use this command to quickly move to the middle of 
the screen from either the top or the bottom. Note that the 
command “dM” deletes from the current line to the line 
specified by the M command. 

Lower Screen - L 

Syntax: [offset]L 

Function: Moves the cursor to the lowest line on the screen. Use 

this command to quickly move to the bottom of the 
screen. If an offset is given, the cursor is homed offset -I 
number of lines from the bottom of the screen. Note that 
the command “dL” deletes all lines from the current line 
to the bottom line shown on the screen. 

Previous Context - '' and "" 

Syntax: 

'character 

"character 

Function: Moves the cursor to previous context or to context marked 

with the m command. If the single quotation mark or 
back quotation mark is doubled, the cursor is moved to 
previous context. If a single character is given after either 
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quotation mark, the cursor is moved to the location of the 
specified mark as defined by the m command. Previous 
context is the location in the file of the last “nonrelative” 
cursor movement. The single quotation mark ( ' ) syntax 
is used to move to the beginning of the line representing 
the previous context. The back quotation mark (' ) syntax 
is used to move to the previous context within a line. 

The Screen Commands 

The screen commands are not cursor movement commands and cannot 

be used in delete commands as the delimiters of text objects. How- 
ever, the screen commands do move the cursor and are useful in pag- 
ing or scrolling through a file. These commands are described below: 

Scroll - Ctrl-U and Ctrl-D 

Syntax: [5/z^]Ctrl-U 

[size]Ctr\-D 

Function: Scrolls the screen up a half window (Ctrl-U) or down a 

half window (Ctrl-D). If size is given, the scroll is size 
number of lines. This value is remembered for all later 
scrolling commands. 

Page - Ctrl-F and Ctrl-B 

Syntax: Ctrl-F 

Ctrl-B 

Function: Pages screen forward and backward. Two lines of con- 

tinuity are kept between pages if possible. A preceding 
count gives the number of pages to move forward or back- 
ward. 

Status - Ctrl-G 

Syntax: BELL 

Ctrl-G 

Function: Displays vi status on status line. This gives you the name 

of the file you are editing, whether it has been modified, 
the current line number, the number of lines in the file, 
and the percentage of the file (in lines) that precedes tlie 
cursor. 

Zero Screen - z 

Syntax: [linenumber]z[size]RET\JRN 

[linenumber]z[size]. 

[linenumber]z[size] - 
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Function: Redraws the display with the current line placed at or 

“zeroed” at the top, middle, or bottom of the screen, 
respectively. If you give a size, the number of lines dis- 
played is equal to size. If a preceding Unenumber is 
given, the given line is placed at the top of the screen. If 
the last argument is a RETURN, the current line is placed 
at the top of the screen. If the last argument is a period 
(.), the current line is placed in the middle of the screen. 
If the last argument is a minus sign (-), the current line is 
placed at the bottom of the screen. 

Redraw - Ctrl-R or Ctrl-L 

Syntax: Ctrl-R 

Ctrl-L 

(Command depends on terminal type.) 

Function: Redraws the screen. Use this command to erase any sys- 

tem messages that may scramble your screen. Note that 
system messages do not affect the file you are editing. 

Text Insertion 

The text insertion commands always place you in insert mode. Exit 
from insert mode is always done by pressing ESC. The following 
insertion commands are “pure” insertion commands; no text is 
deleted when you use them. This differs from the text modification 
commands, change, replace, and substitute, which delete and then 
insert text in one operation. 

Insert - i and I 

Syntax: i[text]ESC 

l[text]ESC 

Function: Insert text in editing buffer. The lowercase i command 

places you in insert mode. Text is inserted before the 
character beneath the cursor. To insert a newline, press a 
RETURN. Exit insert mode by typing the ESC key. The 
uppercase I command places you in insert mode, but 
begins text insertion at the beginning of the current line, 
rather than before the cursor. 

Append - a and A 

Syntax: 2i[text]ESC 

A[text]ESC 

Function: Appends text to the editing buffer. The lowercase a com- 

mand works exactly like the lowercase i command, except 
that text insertion begins after the cursor and not before. 
This is the one way to add text to the end of a line. The 
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uppercase A command begins appending text at the end of 
the current line rather than after the cursor. 

Open New Line - o and O 

Syntax: o[/^jc/]ESC 

0[t^jcr]ESC 

Function: Opens a new line and inserts text. The lowercase o com- 

mand opens a new line below the current line; uppercase 

0 opens a new line above the current line. After the new 
line has been opened, both these commands work like the 

1 command. 



Text Deletion 

Many of the text deletion commands use the D key as an operator. 

This operator deletes text objects delimited by the cursor and a cursor 

movement command. Deleted text is always saved away in a buffer. 

The delete commands are described below: 

Delete Character - x and X 

Syntax: x 

X 

Function: Deletes a character. The lowercase x command deletes 

the character beneath the cursor. With a preceding count, 
count characters are deleted to the right beginning with 
the character beneath the cursor. This is a quick and easy 
way to delete a few characters. The uppercase X com- 
mand deletes the character just before the cursor. With a 
preceding count, count characters are deleted backward, 
beginning with the character just before the cursor. 

Delete - d and D 

Syntax : dcursor-movement 

dd 

D 

Function: Deletes a text object. The lowercase d command takes a 

cursor-movement as an argument. If the cursor-movement 
is an intraline command, deletion takes place from the 
cursor to the end of the text object delimited by the 
cursor-movement . Deletion forward deletes the character 
beneath the cursor; deletion backward does not. If the 
cursor-movement is a multi-line command, deletion takes 
place from and including the current line to the text object 
delimited by the cursor-movement . 
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The dd command deletes whole lines. The uppercase D command 
deletes from and including the cursor to the end of the current line. 

Deleted text is automatically pushed on a stack of buffers numbered 1 
through 9. The most recently deleted text is also placed in a special 
delete buffer that is logically buffer 0. This special buffer is the 
default buffer for all (put) commands using the double quotation mark 
(”) to specify the number of the buffer for delete, put, and yank com- 
mands. The buffers 1 through 9 can be accessed with the p and P (put) 
commands by appending the double quotation mark (”) to the number 
of the buffer. For example: 

"4p 

puts the contents of delete buffer number 4 in your editing buffer just 
below the current line. Note that the last deleted text is “put” by 
default and does not need a preceding buffer number. 

Text Modification 

The text modification commands all involve the replacement of text 
with other text. This means that some text will necessarily be deleted. 
All text modification commands can be “undone” with the u com- 
mand: 

Undo - u and U 

Syntax: u 

U 

Function: Undoes the last insert or delete command. The lowercase 

u command undoes the last insert or delete command. 
This means that after an insert, u deletes text; and after a 
delete, u inserts text. For the purposes of undo, all text 
modification commands are considered insertions. 

The uppercase U command restores the current line to its 
state before it was edited, no matter how many times the 
current line has been edited since you moved to it. 

Repeat - . 

Syntax: 

Function: Repeats the last insert or delete command. A special case 

exists for repeating the p and P “put” commands. When 
these commands are preceded by the name of a delete 
buffer, successive u commands display the contents of the 
delete buffers. 
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Change - c and C 

Syntax: ccursor-movement text ESC 

Ctext ESC 
cctext ESC 

Function: Changes a text object and replaces it with text . Text is 

inserted as with the i command. A dollar sign ($) marks 
the extent of the change. The c command changes arbi- 
trary text objects delimited by the cursor and a cursor- 
movement . The C and cc commands affect whole lines 
and are identical in function. 

Replace - r and R 

Syntax: rchar 

Rtext ESC 

Function: Overstrikes character or line with char or text , respec- 

tively. Use r to overstrike a single character and R to 
overstrike a whole line. A count multiplies the replace- 
ment text count times. 

Substitute - s and S 

Syntax: stext ESC 

Stext ESC 

Function: Substitutes current character or current line with text. Use 

s to replace a single character with new text. Use S to 
replace the current line with new text. If a preceding 
count is given, text substitutes for count number of char- 
acters or lines depending on whether the command is s or 
S, respectively. 

Filter - ! 

Syntax: \cursor-movement and RETURN 

Function: Filters the text object delimited by the cursor and cursor- 

movement through the UNIX command, cmd. For exam- 
ple, the following command sorts all lines between the 
cursor and the bottom of the screen, substituting the 
designated lines with the sorted lines: 

ILsort 

Arguments and shell metacharacters may be included as 
part of cmd\ however, standard input and output are 
always associated with the text object being filtered. 
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Join Lines - J 

Syntax: J 

Function: Joins the current line with the following line. If a count is 

given, count lines are joined. 

Shift - < and > 

Syntax: >[cursor-movement\ 

<[cursor-movement] 

» 

« 

Function: Shifts text right (>) or left (<). Text is shifted by the value 

of the option shiftwidthy which is normally set to eight 
spaces. Both the > and < commands shift all lines in the 
text object delimited by the current line and cursor- 
movement . The » and « commands affect whole lines. 
All versions of the command can take a preceding count 
that acts to multiply the number of objects affected. 



Text Movement 

The text movement commands move text in and out of the named 
buffers a-z and out of the delete buffers 1-9. These commands either 
“yank” text out of the editing buffer and into a named buffer or “put” 
text into the editing buffer from a named buffer or a delete buffer. By 
default, text is put and yanked from the “unnamed buffer”, which is 
also where the most recently deleted text is placed. Thus it is quite 
reasonable to delete text, move your cursor to the location where you 
want the deleted text placed, and then put the text back into the edit- 
ing buffer at this new location with the p or P command. 

The named buffers are most useful for keeping track of several chunks 
of text that you want to keep on hand for later access, movement, or 
rearrangement. These buffers are named with the letters a through z. 
To refer to one of these buffers (or one of the numbered delete buffers) 
in a command, use a quotation mark. For example, to yank a line into 
the buffer named a , enter: 

"ayy 

To put this text back into the file, enter: 

"ap 

If you delete text in the buffer named A rather than a, text is appended 
to the buffer. 
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Note that the contents of the named buffers are not destroyed when 
you switch files. Therefore, you can delete or yank text into a buffer, 
switch files, and then do a put. Buffer contents are destroyed when you 
exit the editor, so be careful. 

Put - p and P 

Syntax: alphanumeric]^ 

[^'alphanumeric^ 

Function: Puts text from a buffer into the editing buffer. If no buffer 

name is specified, text is put from the unnamed buffer. 
The lowercase p command puts text either below the 
current line or after the cursor, depending on whether the 
buffer contains a partial line or not. The uppercase P 
command puts text either above the current line or before 
the cursor, again depending on whether the buffer contains 
a partial line or not. 

Yank - y and Y 

Syntax: [" letter]y cursor-movement 

V'letter]yy 
V'letter]Y 

Function: Copies text in the editing buffer to a named buffer. If no 

buffer name is specified, text is yanked into the unnamed 
buffer. If an uppercase letter is used, text is appended to 
the buffer and does not overwrite and destroy the previous 
contents. When a cursor-movement is given as an argu- 
ment, the delimited text object is yanked. The Y and yy 
commands yank a single line, or, if a preceding count is 
given, multiple lines can be yanked. 



Searching 

The search commands search either forward or backward in the edit- 
ing buffer for text that matches a given regular expression. 

Search - / and ? 

Syntax: /[pattern]/[offset]RET\JRN 

/[pattern]RETmN 
?[pattern]?[offset]RETVRN 
?lpattern]RETVRN 

Function: Searches forward (/) or backward (?) for pattern . A string 

is actually a regular expression. The trailing delimiter is 
not required. If no pattern is given, then last pattern 
searched for is used. After the second delimiter, an offset 
may be given, specifying the beginning of a line relative 
to the line on which pattern was found. For example: 
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/word/- 

finds the beginning of the line immediately preceding the 
line containing “word” and the following command: 

/word/+2 

finds the beginning of the line two lines after the line con- 
taining “word”. See also the ignorecase and magic 
options. 

Next String - n and N 

Syntax: n 

N 

Function: Repeats the last search command. The n command 

repeats the search in the same direction as the last search 
command. The N command repeats the search in the 
opposite direction of the last search command. 

Find Character - f and F 

Syntax: fchar 

Fchar 



Function: Finds character char on the current line. The lowercase f 

searches forward on the line; the uppercase F searches 
backward. The semicolon ( ; ) repeats the last character 
search. The comma (,) reverses the direction of the 
search. 

To Character - 1 and T 

Syntax: ichar 

Tchar 



Function: Moves the cursor up to but not on char. The semicolon 

( ; ) repeats the last character search. The comma ( , ) rev- 
erses the direction of the search. 

Mark - m 

Syntax: mletter 

Function: Marks a place in the file with a lowercase letter. You can 

move to a mark using the “to mark” commands described 
below. It is often useful to create a mark, move the 
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cursor, and then delete from the cursor to the mark “a” 
with the following command: 

da 



To Mark - ' and ' 

Syntax: 'letter 

"letter 

Function: Move to letter. These commands let you move to the 

location of a mark. Marks are denoted by single lower- 
case alphabetic characters. Before you can move to a 
mark, it must first be created with the m command. The 
back quotation mark ( ' ) moves you to the exact location 
of the mark within a line; the forward quotation mark ( ' ) 
moves you to the beginning of the line containing the 
mark. Note that these commands are also legal cursor 
movement commands. 



Exit and Escape Commands 

There are several commands that are used to escape from vi command 
mode and to exit the editor. These are described in the following sec- 
tion. 

ex Escape - : 

Syntax: : 

Function: Enters ex escape mode to execute an ex command. The 

colon appears on the status line as a prompt for an ex 
command. You then can enter an ex command line ter- 
minated by either a RETURN or an ESC and the ex com- 
mand will execute. You are then prompted to type 
RETURN to return to vi command mode. During the input 
of the ex command line or during execution of the ex 
command, you may press INTERRUPT to stop what you 
are doing and return to vi command mode. 

Exit Editor - ZZ 

Syntax: ZZ 

Function: Exit vi and write out the file if any changes have been 

made. This returns you to the shell from which you 
started vi. 

Quit to ex - Q 
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Syntax: Q 

Function: Enters the ex editor. When you do this, you will still be 

editing the same file. You can return to vi by entering the 
vi command from ex. 

ex Commands 



Entering the colon (:) escape command when in command mode pro- 
duces a colon prompt on the status line. This prompt is for a command 
available in the line-oriented editor, ex. In general, ex commands let 
you write out or read in files, escape to the shell, or switch editing 
files. 

Many of these commands perform actions that affect the “current” 
file by default. The current file is normally the file that you named 
when you started vi, although the current file can be changed with the 
“file” command, f, or with the “next” command, n. In most respects, 
these commands are identical to similar commands for the editor, ed. 
All such ex commands are aborted by either RETURN or ESC. We 
shall use RETURN in our examples. Command entry is terminated by 
typing INTERRUPT. 



Command Structure 

Most ex command names are English words, and initial prefixes of the 
words are acceptable abbreviations. In descriptions, only the abbrevi- 
ation is discussed, since this is the most frequently used form of the 
command. The ambiguity of abbreviations is resolved in favor of the 
more commonly used commands. As an example, the command sub- 
stitute can be abbreviated s , while the shortest available abbreviation 
for the set command is se. 

Most commands accept prefix addresses specifying the lines in the file 
that they are to affect. A number of commands also may take a trail- 
ing count specifying the number of lines to be involved in the com- 
mand. Counts are rounded down if necessary. Thus, the command 
“lOp” displays the tenth line in the buffer while “move 5” moves the 
current line after line 5. 

Some commands take other information or parameters, stated after the 
command name. Examples might be option names in a set command, 
such as “set number”, a filename in an edit command, a regular 
expression in a substitute command, or a target address for a copy 
command. For example: 

1,5 copy 25 
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A number of commands have variants. The variant form of the com- 
mand is invoked by placing an exclamation mark (!) immediately after 
the command name. Some of the default variants may be controlled 
by options; in this case, the exclamation mark turns off the meaning of 
the default. 

In addition, many commands take flags, including the characters “p” 
and “1”. A “p” or “1” must be preceded by a blank or tab. In this 
case, the command abbreviated by these characters is executed after 
the command completes. Since ex normally displays the new current 
line after each change, p is rarely necessary. Any number of plus (-f-) 
or minus (-) characters may also be given with these flags. If they 
appear, the specified offset is applied to the current line value before 
the printing command is executed. 

Most commands that change the contents of the editor buffer give 
feedback if the scope of the change exceeds a threshold given by the 
report option. This feedback helps to detect undesirably large 
changes so that they may be quickly and easily reversed with the undo 
command. After commands with global effect, you will be informed if 
the net change in the number of lines in the buffer during this com- 
mand exceeds this threshold. 



Command Addressing 

The following specifies the line addressing syntax for ex commands: ( 

. The current line. Most commands leave the current 

line as the last line which they affect. The default 
address for most commands is the current line, thus 
is rarely used alone as an address. 

n The «th line in the editor’s buffer, lines being num- 

bered sequentially from 1 . 

$ The last line in the buffer. 

% An abbreviation for “1,$”, the entire buffer. 

+/1 or -n An offset, n relative to the current buffer line. The 

forms “.+3” “+3” and are all equivalent. 

If the current line is line 100 they all address line 
103. 

IpatternI or Ipatternl 

Scan forward and backward respectively for a text I 
matching the regular expression given by pattern, ^ 
Scans normally wrap around the end of the buffer. 

If all that is desired is to print the next line contain- 
ing pattern, the trailing slash (/) or question mark 
(?) may be omitted. If pattern is omitted or explic- 
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itly empty, the string matching the last specified 
regular expression is located. The forms 
“RETURN” and “7RETURN” scan using the last 
named regular expression. After a substitute, 
“RETURN” and “??RETURN” would scan using 
that substitute’s regular expression. 

" or 'x Before each nonrelative motion of the current line 

dot (.), the previous current line is marked with a 
label, subsequently referred to with two single quo- 
tation marks ("). This makes it easy to refer or 
return to this previous context. Marks are esta- 
blished with the Vi m command, using a single 
lowercase letter as the name of the mark. Marked 
lines are later referred to with the following nota- 
tion: 

'x. 

where x is the name of a mark. 

Addresses to commands consist of a series of addresses, separated by 
a colon (,) or a semicolon (;). Such address lists are evaluated left to 
right. When addresses are separated by a semicolon (;) the current 
line ( . ) is set to the value of the previous addressing expression before 
the next address is interpreted. If more addresses are given than the 
command requires, all but the last one or two are ignored. If the com- 
mand takes two addresses, the first addressed line must precede the 
second in the buffer. Null address specifications are permitted in a list 
of addresses, the default in this case is the current line thus 
“,100” is equivalent to “.,100”. It is an error to give a prefix address 
to a command which expects none. 



Command Format 

The following is the format for all ex commands: 

[address] [command] [!] [parameters] [count] [flags] 

All parts are optional depending on the particular command and its 
options. The following section describes specific commands. 



Argument List Commands 

The argument list commands allow you to work on a set of files, by 
remembering the list of filenames that are specified when you invoke 
vi. The args command lets you examine this list of filenames. The 
file command gives you information about the current file. The n 
(next) command lets you either edit the next file 
in the argument list or change the list. And the rewind command lets 
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you restart editing the files in the list. All of these commands are 
described below: 

args The members of the argument list are displayed, with 

the current argument delimited by brackets. 

For example, a list might look like this; 

filel file2 [file3] file4 fileS 
The current file is file3, 

f Displays the current filename, whether it has been 

modified since the last write command, whether it is 
read-only, the current linenumber, the number of 
lines in the buffer, and the percentage of the buffer 
that you have edited. In the rare case that the current 
file is “[Not edited]”, this is noted also; in this case 
you have to use w! to write to the file, since the edi- 
tor is not sure that a w command will not destroy a 
file unrelated to the current contents of the buffer. 

ffile The current filename is changed to file which is con- 

sidered ‘ ‘ [Not edited] ’ ’. 

n The next file in the command line argument list is 

edited. 

n! This variant suppresses warnings about the 

modifications to the buffer not having been written 
out, discarding irretrievably any changes that may 
have been made. 

n [+command] file list 

The specified filelist is expanded and the resulting 
list replaces the current argument list; the first file in 
the new list is then edited. If command is given (it 
must contain no spaces), then it is executed after 
editing the first such file. 

The argument list is rewound, and the first file in the 
list is edited. 

Rewinds the argument list discarding any changes 
made to the current buffer. 

If you use C-Shell and set the prompt variable to output a prompt for 
non-interactive shells, the prompt is interpreted as a filename when 
you use these commands. This causes unexpected problems. To avoid 
these problems, use the default prompt value as specified in 
lusrlliblmkuserlmkuser.cshrc. 



rew 

rew! 
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Edit Commands 

To edit a file other than the one you are currently editing, you will 
often use one of the variations of the e command. 

In the following discussions, note that the name of the current file is 
always remembered by vi and is specified by a percent sign (%). The 
name of the previous file in the editing buffer is speci fied by a number 
sign (#). 

The edit commands are described below: 

e file Used to begin an editing session on a new file. The edi- 

tor first checks to see if the buffer has been modified 
since the last w command was issued. If it has been, a 
warning is issued and the command is aborted. The 
command otherwise deletes the entire contents of the 
editor buffer, makes the named file the current file, and 
displays the new filename. After ensuring that this file 
is sensible, (i.e., that it is not a binary file, directory, or 
a device), the editor reads the file into its buffer. If the 
read of the file completes without error, the number of 
lines and characters read is displayed on the status line. 
If there were any non-ASCII characters in the file, they 
are stripped of their non-ASCII high bits, and any null 
characters in the file are discarded. If none of these 
errors occurred, the file is considered edited. If the last 
line of the input file is missing the trailing newline 
character, it is supplied and a complaint issued. The 
current line is initially the first line of the file. 

e! file This variant form suppresses the complaint about 

modifications having been made and not written from 
the editor buffer, thus discarding all changes that have 
been made before editing the new file. 

e -Hn file Causes the editor to begin editing at line n rather than 
at the first line. The argument n may also be an editor 
command containing no spaces; for example, “+/pat- 
tem”. 

Ctrl-" This is a shorthand equivalent for “:e #RETURN’', 

which returns to the previous position in the last edited 
file. If you do not want to write the file, you should use 
“:e! #RETURN” instead. 



Write Commands 

The write commands let you write out all or part of your editing buffer 
to either the current file or to some other file. These commands are 
described below: 
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'wfile Writes changes made back to file, displaying the num- 

ber of lines and characters written. Normally, file is 
omitted and the buffer is written to the name of the 
current file. If file is specified, text is written to that 
file. The editor writes to a file only if it is the current 
file and is edited, or if the file does not exist. Other- 
wise, you must give the variant form w! to force the 
write. If the file does not exist it is created. The 
current filename is changed only if there is no current 
filename; the current line is never changed. 

If an error occurs while writing the current and edited 
file, the editor displays: 

No write since last change 
even if the buffer had not previously been modified. 

w» file Appends the buffer contents at the end of an existing 
file. Previous file contents are not destroyed. 

w! name Overrides the checking of the normal write command, 
and writes to any file that the system permits. 



w Icommand 

Writes the specified lines into command. Note the 
difference between 

w! file 

which overrides checks and 
w \cmd 

which writes to a command. The output of this com- 
mand is displayed on the screen and not inserted in the 
editing buffer. 



Read Commands 

The read commands let you read text into your editing buffer at any 
location you specify. The text you read in must be at least one line 
long, and can 1^ either a file or the output from a command. 

r file Places a copy of the text of the given file in the editing 

buffer after the specified line. If no file is given, the 
current filename is used. The current filename is not 
changed unless there is none, in which case the file 
becomes the current name. If the file buffer is empty 
and there is no current name, this is treated as an e 
command. 
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Address 0 is legal for this command and causes the file 
to be read at the beginning of the buffer. Statistics are 
given as for the e command when the r successfully ter- 
minates. After an r the current line is the last line read. 

r Icommand Reads the output of command into the buffer after the 
specified line. A blank or tab before the exclamation 
mark (!) is mandatory. 



Quit Commands 



There are several ways to exit vi. Some abort the editing session, 
some write out the editing buffer before exiting, and some warn you if 
you decide to exit without writing out the buffer. All of these ways of 
exiting are described below: 



q Exits vi. No automatic write of the editor buffer to a file 

is performed. However, vi displays a warning message if 
the file has changed since the last w command was issued, 
and does not quit, vi also displays a diagnostic if there are 
more files in the argument list left to edit. Normally, you 
will wish to save your changes, and you should enter a w 
command. If you wish to discard them, enter the q! com- 
mand variant. 



q! Quits from the editor, discarding changes to the buffer 

without complaint. 

wq name Like a w and then a q command. 

wq! name Overrides checking normally made before execution of 
the w command to any file. For example, if you own a file 
but do not have write permission turned on, the wq! 
allows you to update the file anyway. 

X name If any changes have been made and not written, writes the 
buffer out and then quits. Otherwise, it just quits. 



Global and Substitute Commands 

The global and substitute commands allow you to perform complex 
changes to a file in a single command. Learning how to use these 
commands is a must for an experienced vi user. 

gipatternicmds 

The g command has two distinct phases. In the first 
phase, each line matching pattern in the editing buffer is 
marked. Next, the given command list is executed with 
the current line, dot ( . ), initially set to each marked line. 
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The command list consists of the remaining commands on 
the current input line and may continue to multiple lines 
by ending all but the last such line with a backslash (\). 
This multiple-line option will not work from within v/, 
you must switch to ex to do it. If cmds (or the trailing 
slash (/) delimiter) is omitted, each line matching pattern 
is displayed. 

The g command itself may not appear in cmds. The 
options autoprint and autoindent are inhibited during a 
global command and the value of the report option is 
temporarily infinite, in deference to a report for the entire 
global. Finally, the context mark ( ') or (' ) is set to the 
value of the current line ( . ) before the global command 
begins and is not changed during a global command. 

The following global commands, most of them substitu- 
tions, cover the most frequent uses of the global com- 
mand. 

g/s7/p This command simply prints all lines that contain 

the string “si” . 

gisllsllsll This command substitutes the first occurrence of 

“si” on all lines that contain it with the string 
“s2”. 

gisllsllsllg This command substitutes all occurrences of “si” 
with the string “s2”. This includes multiple occur- 
rences of “si” on a line. 

gisllsllsligtp This command works the same as the preceding 
example, except that in addition, all changed lines 
are displayed on the screen. 

gisllsllsllgc This command prompts you to confirm that you 
want to make each substitution of the string “si” 
with the string “s2”. If you enter a Y , the given 
substitution is made, otherwise it is not. 

gIsOlsIslIslIg This command marks all those lines that contain the 
string “sO”, and then for those lines only, substi- 
tutes all occurrences of the string “si” with “s2”. 

gUpatternlcmds This variant form of g runs cmds at each line not 
matching pattern. 

g/7s// /g This command inserts blank spaces at the beginning 

of each line in a file. 
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sipatternirepll options 

On each specified line, the first instance of text 
matching the regular expression pattern is replaced 
by the replacement text repl. If the global indicator 
option character g appears, all instances on a line 
are substituted. If the confirm indication character 
c appears, before each substitution the line to be 
substituted is printed on the screen with the string 
to be substituted marked with caret (") characters. 
By entering Y , you cause the substitution to be per- 
formed; any other input causes no change to take 
place. After an s command, the current line is the 
last line substituted. 

\lpatternlcmds A synonym for the global command variant g!, run- 
ning the specified cmds on each line that does not 
match pattern 



Text Movement Commands 

The text movement commands are largely superseded by commands 
available in vi command mode. However, the following two com- 
mands are still quite useful: 

CO addr flags A copy of the specified lines is placed after addr, 

which may be “0’’. The current line addresses 
the last line of the copy. 

[range]maddr The m command moves the lines specified by range 
after the line given by addr. For example, m+ 
swaps the current line and the following line, since 
the default range is just the current line. The first of 
the moved lines becomes the current line (dot). 



Shell Escape Commands 

You will often want to escape from the editor to execute normal UNIX 
commands. You may also want to change your working directory so 
that your editing can be done with respect to a different working direc- 
tory. These operations are described below: 

cd directory The specified directory becomes the current direc- 
tory. If no directory is specified, the current value 
of the home option is used as the target directory. 
After a cd , the current file is not considered to have 
been edited so that write restrictions on preexisting 
files still apply. 
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sh A new shell is created. You may invoke as many 

commands as you like in this shell. To return to vf, 
enter a Ctrl-D to terminate the shell. 

Icommand The remainder of the line after the exclamation (!) 

is sent to a shell to be executed. Within the text of 
command , the characters and are 

expanded as the filenames of the current file and the 
last edited file and the character “I” is replaced 
with the text of the previous command. Thus, in 
particular, “I!” repeats the last such shell escape. 
If any such expansion is performed, the expanded 
line is echoed. The current line is unchanged by 
this command. 

If there has been “[No write]” of the buffer contents since the last 
change to the editing buffer, a diagnostic is displayed before the com- 
mand is executed as a warning. A single exclamation (!) is displayed 
when the command completes. 

If you use C-Shell and set the prompt variable to output a prompt for 
non-interactive shells, the prompt is interpreted as an argument for 
command in shell escapes. This causes unexpected problems. To 
avoid these problems, use the default prompt value as specified in 
lusrilibimkuserimkuser. cshrc. 



Other Commands 

The following command descriptions explain how to use miscellane- 
ous ex commands that do not fit into the above categories. 

The abbr, map, and set commands can also be defined with the 
EXINIT environment variable, which is read by the editor each time it 
starts up. For more information, see environ{M). Alternatively, these 
commands can be placed in a .exrc file in your home directory, which 
the editor reads if EXINIT is not defined. 

abbr Maps the first argument to the following string. For exam- 
ple, the following command 

:abbr rainbow yellow green blue red 

maps “rainbow” to “yellow green blue red”. Abbrevia- 
tions can be turned off with the unabbreviate command, 
as in: 



:una rainbow 

map, map! Maps any character or escape sequence to a command 
sequence. For example, the following command maps the 
CTRL-A key to a shell escape that runs the clear {C) 
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command: 

map "A ilclear^M 

To include the CTRL-A and CTRL-M characters in the 
mapping, you must use vi ’s CTRL-V escape. 

Characters mapped with map work in command mode, 
while characters mapped with map! work in insert mode. 
Characters mapped with map! cannot be unmapped using 

unmap. 

nu Displays each specified line preceded by its buffer line 

number. The current line is left at the last line displayed. 
To get automatic line numbering of lines in the buffer, set 
the number option. 

preserve The current editor buffer is saved as though the system 
had just crashed. This command is for use only in emer- 
gencies when a w command has resulted in an error and 
you do not know how to save your work. 

= Displays the line number of the addressed line. The 

current line is unchanged. 



recover file 

Recovers file from the system save area. The system 
saves a copy of the editing buffer only if you have made 
changes to the file, the system crashes, or you execute a 
preserve command. When you use preserve , you are 
notified by mail when a file is saved. 

set argument 

With no arguments, set displays those options whose 
values have been changed from their defaults; with the 
argument all, it displays all of the option values. 

Giving an option name followed by a question mark (?) 
causes the current value of that option to be displayed. 
The question mark is unnecessary unless the option is a 
Boolean value. Switch options are given values either 
with: 



set option 
to turn them on or: 

set nooption 

to turn them off. String and numeric options are assigned 
with: 
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set option=\d\nQ 

More than one option can be given to set\ all are inter- 
preted from left to right. See “Options” for a complete 
list and descriptions. 

tag label The focus of editing switches to the location of label. If 
necessary, vi will switch to a different file in the current 
directory to find label. If you have modified the current 
file before giving a tag command, you must first write it 
out. If you give another tag command with no argument, 
the previous label is used. 

Similarly, if you press Ctrl-], vi searches for the word 
immediately after the cursor as a tag. This is equivalent 
to entering “:tag”, the word following the cursor, and 
then pressing the RETURN key. 

The tags file is normally created by a program such as 
ctags, and consists of a number of lines with three fields 
separated by blanks or tabs. The first field gives the name 
of the tag, the second the name of the file where the tag 
resides, and the third gives an addressing form which can 
be used by the editor to find the tag. This field is usually a 
contextual scan using j pattern j to be immune to minor 
changes in the file. Such scans are always performed as if 
the nomagic option was set. The tag names in the tags 
file must be sorted alphabetically. 

unmap Unmaps any character or escape sequence that has been 
mapped using the map command. 



Options 

There are a number of options that can be set to affect the vi environ- 
ment. These can be set with the ex set command while editing, with 
the EXINIT environment variable, or in the vi start-up file, .exrc. This 
file normally sets the user’s preferred options so that they do not need 
to be set manually each time you invoke vi . 

The first thing that must be done before you can use v/, is to set the 
terminal type so that vi understands how to talk to the particular termi- 
nal you are using. 

There are only two kinds of options: switch options and string options. 
A switch option is either on or off. A switch is turned off by prefixing 
the word no to the name of the switch within a set command. String 
options are strings of characters that are assigned values with the syn- 
tax option- string . Multiple options may be specified on a line, vi 
options are listed below: 
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autoindent, ai default: noai 

Can be used to ease the preparation of structured program text. For 
each line created by an append, change, insert, open, or substitute 
operation, vi looks at the preceding line to determine and insert an 
appropriate amount of indentation. To back the cursor up to the 
preceding tab stop, press Ctrl-D. The tab stops going backward are 
defined as multiples of the shiftwidth option. You cannot back- 
space over the indent, except by pressing Ctrl-D. 

Specially processed in this mode is a line with no characters added 
to it, which turns into a completely blank line (the whitespace pro- 
vided for the autoindent is discarded). Also, specially processed 
in this mode are lines beginning with a caret ( " ) and immediately 
followed by a Ctrl-D. This causes the input to be repositioned at 
the beginning of the line, but retains the previous indent for the 
next line. Similarly, a “0” followed by a Ctrl-D, repositions the 
cursor at the beginning without retaining the previous indent. 
Autoindent doesn’t happen in global commands. 

autoprint ap default: ap 

Causes the current line to be displayed after each ex copy, move, 
or substitute command. This has the same effect as supplying a 
trailing “p” to each such command. Autoprint is suppressed in 
globals, and only applies to the last command on a line. 

autowrite, aw default: noaw 

Causes the contents of the buffer to be automatically written to the 
current file if you have modified it when you give a next, rewind, 
tag, or ! command, or a Ctrl-" (switch files) or Ctrl-] (tag go to) 
command. 

beautify, bf default: nobeautify 

Causes all control characters except tab, newline and formfeed to 
be discarded from the input. A complaint is registered the first 
time a backspace character is discarded. Beautify does not apply 
to command input. 

directory, dir default: dir=/tmp 

Specifies the directory in which vi places the editing buffer file. If 
the directory does not have write permission, the editor will exit 
abruptly when it fails to write to the buffer file. 

edcompatible default: noedcompatible 

Causes the presence or absence of g and c suffixes on substitute 
commands to be remembered, and to be toggled on and off by 
repeating the suffixes. The suffix r causes the substitution to be like 
the tilde C) command, instead of like the ampersand command 
(&). 

errorbells, eb default: noeb 

Error messages are preceded by a bell. If possible, the editor 
always places the error message in inverse video instead of ringing 
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the bell. 

hardtabs, ht default: ht=8 

Gives the boundaries on which terminal hardware tabs are set or on 
which tabs the system expands. 

ignorecase, ic default: noic 

Maps all uppercase characters in the text to lowercase in regular 
expression matching. In addition, all uppercase characters in regu- 
lar expressions are mapped to lowercase except in character class 
specifications enclosed in brackets. 

lisp default: nolisp 

Autoindent indents appropriately for LISP code, and the ( ) { } [[ 
and ]] commands are modified to have meaning for LISP. 

list default: nolist 

All printed lines are displayed, showing tabs and end-of-lines. 
magic default: magic 

If nomagic is set, the number of regular expression metacharacters 
is greatly reduced, with only up-arrow ('') and dollar sign ($) hav- 
ing special effects. In addition, the metacharacters and 
in replacement patterns are treated as normal characters. All the 
normal metacharacters may be made magic when nomagic is set 
by preceding them with a backslash (\). 

mesg default: nomesg 

Causes write permission to be turned off to the terminal while you 
are in visual mode, if nomesg is set. This prevents people writing 
to your screen with the UNIX write command and scrambling your 
screen as you edit. 

number, n default: nonumber 

Causes all output lines to be printed with their line numbers. 

open default: open 

If set to noopen, the commands open and visual are not permitted 
from ex. This is set to prevent confusion resulting from accidental 
entry to open or visual mode. 

optimize, opt default: optimize 

Output of text to the screen is expedited by setting the terminal so 
that it does not perform automatic carriage returns when displaying 
more than one line of output, thus greatly speeding output on ter- 
minals without addressable cursors when text with leading whi- 
tespace is printed. 

paragraphs, para default: para =IPLPPPQPP TPbp 

Specifies paragraph delimiters for the { and } operations. The pairs 
of characters in the option’s value are the names of the nroff mac- 
ros that start paragraphs. 
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prompt default: prompt 

ex input is prompted for with a colon (:). If noprompt is set, when 
ex command mode is entered with the Q command, no colon 
prompt is displayed on the status line. 

redraw default: noredraw 

The editor simulates (using great amounts of output), an intelligent 
terminal on a dumb terminal. Useful only at very high speed. 

remap default: remap 

If on, mapped characters are repeatedly tried until they are 
unchanged. For example, if o is mapped to O and O is mapped to /, 
o will map to / if remap is set, and to O if noremap is set. 

report default: report=5 

Specifies a threshold for feedback from commands. Any command 
that modifies more than the specified number of lines will provide 
feedback as to the scope of its changes. For global commands and 
the undo command, the net change in the number of lines in the 
buffer is presented at the end of the command. Thus notification is 
suppressed during a g command on the individual commands per- 
formed. 

scroll default: scroll =!/2 window 

Determines the number of logical lines scrolled when Ctrl-D is 
received from a terminal input in command mode, and the number 
of lines displayed by a command mode z command (double the 
value of scroll). 

sections default: sections=SHNHH HU 

Specifies the section macros for the [[ and ]] operations. The pairs 
of characters in the option’s value are the names of the nroff mac- 
ros that start paragraphs. 

shell, sh default: sh=/bin/sh 

Gives the pathname of the shell forked for the shell escape com- 
mand (!), and by the shell command. The default is taken from 
SHELL in the environment, if present. 

shiftwidth, sw default:sw=8 

Gives the width of a software tab stop, used in reverse tabbing with 
Ctrl-D when using autoindent to append text, and by the shift com- 
mands. 

showmatch, sm default: nosm 

When a ) or } is typed, moves the cursor to the matching ( or { for 
one second if this matching character is on the screen. 

showmode default: noshowmode 

Causes the message “INPUT MODE to appear on lower right 
comer of the screen when insert mode is activated. 
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slowopen default: noslowopen 

Postpones update of the display during inserts. 

tabstop, ts default: ts=8 

The editor expands tabs in the input file to be on n boundaries for 
the purposes of display. 

taglength, tl default: tl=0 

The first n characters in a tag name are significant, but all others 
are ignored. A value of zero (the default) means that all characters 
are significant. 

tags default: tags=tags /usr/lib/tags 

A path of files to be used as tag files for the tag command. A 
requested tag is searched for in the specified files, sequentially. By 
default, files named tag are searched for in the current directory 
and in /usr/lib. 

term default=value of shell TERM variable 

The terminal type of the output device. 

terse default: noterse 

Shorter error diagnostics are produced for the experienced user, 

timeout , to default: noto 

Eliminates the 1 second time limit for maps (character mappings), 
warn default: warn 

Warn if there has been “[No write since last change]” before a 
shell escape command (!). 

window default: window = speed dependent 

This specifies the number of lines in a text window. The default is 
8 at slow speeds (600 baud or less), 16 at medium speed (1200 
baud), and the full screen (minus one line) at higher speeds. 

w300, wl200, w9600 

These are not true options but set window (above) only if the 
speed is slow (300), medium (1200), or high (9600), respectively. 

wrapscan, ws default: ws 

Searches, using the regular expressions in addressing, will wrap 
around past the end of the file. 

wrapmargin, wm default: wm=0 

Defines the margin for automatic insertion of newlines during text 
input. A value of zero specifies no wrap margin. 

writeany, wa default: nowa 

Inhibits the checks normally made before write commands, allow- 
ing a write to any file that the system protection mechanism will 
allow. 
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Regular Expressions 



A regular expression specifies a set of strings of characters. A mem- 
ber of this set of strings is said to be “matched’ ’ by the regular expres- 
sion. vi remembers two previous regular expressions; the previous 
regular expression used in a substitute command and the previous reg- 
ular expression used elsewhere, referred to as the previous scanning 
regular expression. The previous regular expression can always be 
referred to by a null regular expression: e.g., or 

The regular expressions allowed by vi are constructed in one of two 
ways depending on the setting of the magic option. The ex and vi 
default setting of magic gives quick access to a powerful set of regu- 
lar expression metacharacters. The disadvantage of magic is that the 
user must remember that these metacharacters are magic and precede 
them with the backslash (\) to use them as “ordinary” characters. 
With nomagic set, regular expressions are much simpler, there being 
only two metacharacters. The power of the other metacharacters is 
still available by preceding the now ordinary character with a “\”. 
Note that “\” is always a metacharacter. In this discussion, the magic 
option is assumed. With nomagic , the only special characters are the 
caret O at the beginning of a regular expression, the dollar sign ($) at 
the end of a regular expression, and the backslash (\). The tilde (~) 
and the ampersand (&) also lose their special meanings related to the 
replacement pattern of a substitute. 

The following basic constructs are used to construct magic mode reg- 
ular expressions. 

char An ordinary character matches itself. Ordinary characters are 
any characters except a caret ( " ) at the beginning of a line, a 
dollar sign ($) at the end of line, a star (*) as any character other 
than the first, and any of the following characters: 

.\ [ ^ 

These characters must be preceded by a backslash (\) if they are 
to be treated as ordinary characters. 

At the beginning of a pattern, forces the match to succeed only 
at the beginning of a line. 

$ At the end of a regular expression, forces the match to succeed 
only at the end of the line. 

. Matches any single character except the newline character. 

\< Forces the match to occur only at the beginning of a “word”; 
that is, either at the beginning of a line, or just before a letter, 
digit, or underline and after a character not one of these. 
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\> Similar to but matching the end of a “word”, i.e., either 
the end of the line or before a character which is not a letter, a 
digit, or the underline character. 

[string] 

Matches any single character in the class defined by string. 
Most characters in string define themselves. A pair of charac- 
ters separated by a dash (-) in string defines the set of characters 
between the specified lower and upper bounds, thus “[a-z]” as a 
regular expression matches any single lowercase letter. If the 
first character of string is a caret ( " ) then the construct matches 
those characters which it otherwise would not. Thus “["a-z]” 
matches anything but a lowercase letter or a newline. To place 
any of the characters caret, left bracket, or dash in string they 
must be escaped with a preceding backslash (\). 

The concatenation of two regular expressions first matches the left- 
most regular expression and then the longest string that can be recog- 
nized as a regular expression. The first part of this new regular 
expression matches the first regular expression and the second part 
matches the second. Any of the single character matching regular 
expressions mentioned above may be followed by a star () to form a 
regular expression that matches zero or more adjacent occurrences of 
the characters matched by the prefixing regular expression. The tilde 
O may be used in a regular expression to match the text that defined 
the replacement part of the last s comipand. A regular expression may 
be enclosed between the sequences “X” and “\)” to remember the 
text matched by the enclosed regular expression. This text can later 
be interpolated into the replacement text using the following notation: 

\ digit 

where digit enumerates the set of remembered regular expressions. 

The basic metacharacters for the replacement pattern are the amper- 
sand (&) and the tilde O; these are given as “\&” and when 
nomagic is set. Each instance of the ampersand is replaced by the 
characters matched by the regular expression. In the replacement pat- 
tern, the tilde stands for the text of the previous replacement pattern. 

Other metasequences possible in the replacement pattern are always 
introduced by a backslash (\). The sequence “\n” is replaced by the 
text matched by the nth regular subexpression enclosed between “\(” 
and “\)”. When nested, parenthesized subexpressions are present, n 
is determined by counting occurrences of “\(” starting from the left. 
The sequences “\u” and “\1” cause the immediately following char- 
acter in the replacement to be converted to uppercase or lowercase, 
respectively, if this character is a letter. The sequences “\U” and 
“\L” turn such conversion on, either until “\E” or “\e” is encoun- 
tered, or until the end of the replacement pattern. 
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Files 



Amp 


default directory where temporary work 
files are placed; it can be changed using 
the directory option (see the ex{C) set 
command.). 


/usr/lib/terminfo/? /* 


compiled terminal description database 


/usr/lib/.COREterm/?/* 


subset of compiled terminal description 
database 


Credit 




This utility was developed at the University of California at Berkeley 
and is used with permission. 


Notes 





The /usr/lib/ex3.7preserve program can be used to restore vi buffer 
files that were lost as a result of a system crash. The program searches 
the /tmp directory for vi buffer files and places them in the directory 
/usr/preserve. The owner can retrieve these files using the -r option. 

The /usr/lib/ex3.7preserve program must be placed in the system 
startup file, /etc/rc.d/3/recovery, before the command that cleans out 
the /tmp directory. See the System Administrator' s Guide for more in- 
formation on the /etc/rc2 scripts. 

Two options, although they continue to be supported, have been re- 
placed in the documentation by the options that follow the Command 
Syntax Standard (see intro (C)). A -r option that is not followed with 
an argument has been replaced by -L and -{-command has been re- 
placed by -c command. 

vi does not strip the high bit from 8 bit characters read in from text 
files, text insertion, and editing commands. It does not look for magic 
numbers of object files when reading in a text file. It also writes out 
text and displays text without stripping the high bit. 

vi uses the LC_CTYPE environment variable to determine if a char- 
acter is printable, displaying the octal codes of non-printable 8 bit 
characters. It also uses LC_CTYPE and LANG to convert between 
upper and lowercase characters for the tilde command and for the ig- 
norecase option. 
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When the percent sign (%) is used in a shell escape from vi via the 
exclamation mark (!) the % is replaced with the name of the file being 
edited. In previous versions of vi, each character in this replacement 
had the high bit set to 1 to quote it; in the current version of vi it is left 
alone. 

Warnings 



Tampering with the entries in /usr/Iib/.COREterm/?/* or 
/usnlib/terminfo/? /* (for example, changing or removing an entry) 
can affect programs such as vi that expect all entries to be present and 
correct. In particular, removing the “dumb” terminal entry may 
cause unexpected problems. 

Software tabs using "T work only immediately after the autoindent. 

Left and right shifts on intelligent terminals do not make use of insert 
and delete operations in the terminal. 

Refer to the cryptiC) page for information about restrictions on the 
availability of encryption options. 

Standards Conformance 



vedit and view are conformant with: 

AT&TSVID Issue 2, Select Code 307-127. 

vi is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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vidi 

sets the font and video mode for a video device 

Syntax 



vidi [ -d ] [ -f fontfile ] command 

Description 



vidi sets video mode or loads/extracts a font from the device that is the 
current standard input; without arguments, it lists the all of the valid 
video mode and font commands. 

Some video cards support changeable character fonts. The vidi font 
commands (fontSxS, font8xl4, and font8xl6) are used to load and 
extract fonts from the tables stored in the kernel. If neither of the -d 
or -f options has been specified, vidi will attempt to load the specified 
font from i/usr/lib/vidi/7<9«^n(2m^. he -d option causes vidi to read the 
specified font from the kernel and write (dump) the font to the stan- 
dard output. 

The -f option is used to load fonts other than those in /usrAib/vidi or to 
specify an output file other than standard output. When loading a font, 
-f filename will load the font from filename instead of from 
IwsxHxhlvidilfontname. When extracting a font (-d option) -f filename 
causes vidi to write the extracted font into filename instead of writing 
the font to the standard output. 

The other vidi commands set the video mode of the video adapter con- 
nected to vidi's standard input. The commands are : 

mono 

move current screen to the monochrome adapter, 
cga 

move current screen to the Color Graphics adapter, 
ega 

move current screen to the Enhanced Graphics adapter, 
vga 

move current screen to the Video Graphics adapter, 
internal 

activate the internal monitor on portable with a plasma screen. 

\ external 

activate the external monitor on portable with a plasma screen. 
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Text Modes i 


Command 


Cols 


Rows 


Font 


Adapter 


c40x25 


40 


25 


8x8 


CGA (EGA VGA) 


e40x25 


40 


25 


8x14 


EGA (VGA) 


v40x25 


40 


25 


8x16 


VGA 


m80x25 


80 


25 


8x14 


MONO (EGA MONO VGA MONO) 


c80x25 


80 


25 


8x8 


CGA (EGA VGA) 


em80x25 


80 


25 


8x14 


EGA MONO (VGA MONO) 


e80x25 


80 


25 


8x14 


EGA (VGA) 


vm80x25 


80 


25 


8x16 


VGA MONO 


v80x25 


80 


25 


8x16 


VGA 


e80x43 


80 


43 


8x14 


EGA (VGA) 



Graphics Modes I 


Command 


Pixel Resolution 


Colors 


mode5 


320x200 


4 


mode6 


640x200 


2 


modeD 


320x200 


16 


modeE 


640x200 


16 


modeF 


640x350 


2 (mono) 


mode 10 


640x350 


16 


mode 11 


640x480 


2 


mode 12 


640x480 


16 


mode 13 


320x200 


256 



See Also 



screen(HW) 



Notes 



The internal and external commands do not work with 
all types of portables. 
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vmstat 

report paging and system statistics 

Syntax 

vmstat [ -fs ] [ -n namelist ] [ -1 lines ] [ interval [ count )] 

Description 



vmstat reports some statistics kept by the system on processes, 
demand paging, and cpu and trap activity. Three types of reports are 
available: 

(default) 

A summary of the number of processes in various states, paging 
activity, system activity, and cpu cycle consumption. 

-f Number of /<9r/:(S)’s done. 

-s A verbose listing of paging and trap activity. 

If no interval or count is specified, the totals since system bootup are 
displayed. 

If an interval is given, the number of events that have occurred in the 
last interval seconds is shown. If no count is specified, this display is 
repeated forever every interval seconds. Otherwise, when a count is 
also specified, the information is displayed count times. 

Other flags that may be specified include: 

-n namelist 

Use file namelist as an alternate symbol table instead of /unix. 

-1 lines 

For the default display, repeat the header every lines reports 
(default is 20). 

The fields in the default report are: 
procs 

The number of processes which are: 
r In the run queue. 
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b Blocked waiting for resources, 
w Swapped out. 

These values always reflect the current situation, even if the totals 
since boot are being displayed. 

paging 

Reports on the performance of the demand paging system. Unless 
the totals since boot are being displayed, this information is aver- 
aged over the proceeding interval seconds: 

frs Free swap space. 

dmd 

Demand zero and demand fill pages, 
sw Pages on swap. 

cch 

Pages in cache, 
fil Pages on file. 

pft 

Protection faults. 

frp 

Pages freed, 
pos 

Processes swapped out successfully. 

pif 

Processes swapped out unsuccessfully. 

rso 

Regions swapped out. 
rsi Regions swapped in. 
system 

Reports on the general system activity. Unless the totals since 
boot are being shown, these figures are averaged over the last 
interval seconds: 

sy Number of system calls. 

cs Number of context switches. 
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cpu 

Percentage of cpu cycles spent in various operating modes: 
us User, 
su System, 
id Idle. 

This information may not be displayed on some systems. 

The -f and -s reports are a series of lines of the form: 
number description 

which means that number of the items described by description hap- 
pened (either since boot or in the last interval seconds, as appropri- 
ate). These reports should be self-explanatory. 

Files 



/unix 

Default namelist, 
/dev/kmem 

Default source of statistics. 

See Also 



fork(S), ps(C), pstat(C) 

Authorization 



The behavior of this utility is affected by assignment of the mem 
authorization, which is usually reserved for system administrators. If 
you do not have this authorization, the command will not work. Refer 
to the “Using a Trusted System” chapter of the User's Guide for more 
details. 
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W 

displays information about who is on the system and 
what they are doing 

Syntax 

w [-hlqtw] [-n namelist] [-s swapdev] [-u utmpfile] [users...] 

Description 



w prints a summary of the current activity on the system, including 
what each user is doing. The heading line shows the current time of 
day, how long the system has been up, and the number of users logged 
onto the system. On systems that maintain the necessary data, the 
heading line also shows load averages. Load averages are the number 
of processes in the run queue averaged over 1,5, and 15 minutes. 

The options are: 

-h Don’t print the heading or title lines. 

-1 

Long format (default): For each user, w outputs the user’s login 
name, the terminal or pseudo terminal the user is currently using, 
when the user logged onto the system, the number of minutes the 
user has been idle (how much time has expired since the user last 
typed anything), the CPU time used by all processes and their chil- 
dren attached to the terminal, the CPU time used by the currently 
active process, and the name and arguments of the currently active 
process. 

-q Quick format: For each user, w outputs the user’s login name, the 
terminal or pseudo terminal the user is currently using, the number 
of minutes the user has been idle, and the name of the currently 
active process. 



-t 

Only the heading line is output (equivalent to uptime(C)). 
-w Both the heading line and the summary of users is output. 
•nnamelist 

The argument is taken as the name of an alternate namelist 
( /unix is the default). 
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-sswapdev 

Uses the file swapdev in place of /dev/swap. This is useful when 
examining a corefile. 

-uutmpfde 

The file utmpfile is used instead of letclutmp as a record of who is 
currently logged in. 

If any users are given, the user summary is restricted to reporting on 
those users. 

Files 



/unix 

/etc/utmp 

/dev/kmem 

/dev/swap 

See Also 



date(C), finger(C), ps(C), uptime(C), who(C), whodo(C) 

Notes 



The “currently active process” is only an approximation and is not 
always correct. Pipelines can produce strange results, as can some 
background processes. If w is completely unable to guess at the 
currently active process, it prints 

Authorization 



The behavior of this utility is affected by assignment of the mem 
authorization, which is usually reserved for system administrators. If 
you do not have this authorization, the output will be restricted to data 
pertaining to your activities only. Refer to the “Using a Trusted Sys- 
tem” chapter of the User's Guide for more details. 



March 15. 1989 



W-2 





WAIT(C) 



WAIT (C) 



wait 

awaits completion of background processes 

Syntax 



wait 

Description 



Waits until all background processes started with an ampersand (&) 
have finished, and reports on abnormal terminations. 

wait is built in to csh and sh. 

Because the wait(S) system call must be executed in the parent pro- 
cess, the shell itself executes wait, without creating a new process. 

See Aiso 



csh(C), sh(C) 

Notes 



Not all the processes of a pipeline with three or more stages are chil- 
dren of the shell, and thus cannot be waited for. 

Standards Conformance 



wait is conformant with: 

AT&TSVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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WC 

counts lines, words and characters 

Syntax 



WC [ -Iwc ] [ names ] 

Description 



WC counts lines, words and characters in the named files, or in the 
standard input if no names appear. It also keeps a total count for all 
named files. A word is a maximal string of characters delimited by 
spaces, tabs, or newlines. 

The options 1, w, and c may be used in any combination to specify that 
a subset of lines, words, and characters are to be reported. The default 
is -Iwc. 

When names are specified on the command line, they are printed 
along with the counts. 

Standards Conformance 



WC is conformant with: 

AT&TSVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 



N 
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what 

identifies files 

Syntax 

what files 

Description 



what searches the given files for all occurrences of the pattern @(#) 
and prints out what follows until the first tilde ( ' ), greater-than sign 
(>), new-line, backslash (\) or null character. The SCCS command 
g^t(CP) substitutes this string as part of the @(#) string. 

For example, if the shell procedure in file print contains 

# 0(#)this is the print program 

# @{#) syntax: print [files] 
pr $* I Ipr 

then the command 

what print 

displays the name of the file print and the identifying strings in that 
file: 



print : 

this is the print program 
syntax: print [files] 

what is intended to be used with the get{C?) command, which auto- 
matically inserts identifying information, but it can also be used where 
the information is inserted manually. 

See Also 



admin(CP), get(CP) 

Standards Conformance 



what is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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who 

lists who is on the system 

Syntax 



who [ -uATHIdtasqbrp ] [ file ] 
who am i 
who am I 

Description 



who can list the user’s name, terminal line, login time, and the elapsed 
time since activity occurred on the line; it also lists the process ID of 
the command interpreter (shell) for each current user. It examines the 
/tcb/files/inittab file to obtain information for the Comments column, 
and /etc/utmp to obtain all other information. If file is given, that file 
is examined. Usually, /I/e will be /etc/wtmp, which contains a history 
of all the logins since the file was last created. 

who with the am i or am I option identifies the invoking user. 

Except for the default -s option, the general format for output entries 
is: 



name [state] line time activity pid [comment] [exit] 

With options, who can list logins, logoffs, reboots, and changes to the 

system clock, as well as other processes spawned by the init process. 

These options are: 

-u This option lists only those users who are currently logged in. 
The name is the user’s login name. The line is the name of the 
line as found in the directory /dev. The time is the time that 
the user logged in. The activity is the number of hours and 
minutes since activity last occurred on that particular line. A 
dot (.) indicates that the terminal has seen activity in the last 
minute and is therefore “current”. If more than twenty-four 
hours have elapsed or the line has not been used since boot 
time, the entry is marked old. This field is useful when trying 
to determine whether a person is working at the terminal or 
not. The pid is the process ID of the user’s shell. The comment 
is the comment field. It can contain information about where 
the terminal is located, the telephone number of the dataset, 
the type of terminal if hard- wired, etc. 
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-A This option displays UNIX accounting information. 

-T This option is the same as the -u option, except that the state of 
the terminal line is printed. The state descril^s whether some- 
one else can write to that terminal. A plus character (+) 
appears if the terminal is writable by anyone; a minus charac- 
ter (-) appears if it is not. Root can write to all lines having a 
plus character (+) or a minus character (-) in the state field. If 
a bad line is encountered, a question mark (?) is displayed. 

-1 This option lists only those lines on which the system is wait- 
ing for someone to login. The name field is LOGIN in such 
cases. Other fields are the same as for user entries except that 
the state field does not exist. 

-H This option displays column headings above the regular output. 

-q This is a quick who, displaying only the names and the number 
of users currently logged on. When this option is used, all 
other options are ignored. 

-d This option displays all processes that have expired and have 
not been respawned by init . The exit field appears for dead 
processes and contains the termination and exit values (as 
returned by wait(S)), of the dead process. This can be useful in 
determining why a process terminated. 

-t This option indicates the last change to the system clock (via 
the date(C) command) by root. See su(C), 

-a This option processes the /etc/utmp file or the named file with 
all options turned on. 

-s This option is the default and lists only the name, line, and 
time fields. 

-p This option lists any other process which is currently active 
and has been previously spawned by init . The name field is the 
name of the program executed by init as found in 
/tcb/files/inittab. The state, line, and idle fields have no 
meaning. The comment field shows the id field of the line from 
/tcb/files/inittab that spawned this process. See inittab(F). 

-b This option indicates the time and date of the last reboot. 

-r This option indicates the current run- level of the init process. 
In addition, it produces the process termination status, process 
id, and process exit status [see utmp(F)] under the idle, pid, 
and comment headings, respectively. 
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WHO (C) 

Files 



WHO (C) 



/etc/utmp 

/etc/wtmp 

/tcb/files/inittab 

See Also 



date(C), login(M), mesg(C), su(C), utmp(F), inittab(F), wait(S) 

Standards Conformance 



who is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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whodo 

determines who is doing what 

Syntax 



/etc/whodo 

Description 



whodo produces merged, reformatted, and dated output from the 
who{C) and ps{C) commands. 

See Aiso 



ps(C), who(C) 

Authorization 



The behavior of this utility is affected by assignment of the mem 
authorization, which is usually reserved for system administrators. If 
you do not have this authorization, the output will be restricted to data 
pertaining to your activities only. Refer to the “Using a Trusted Sys- 
tem” chapter of the User's Guide for more details. 

Standards Conformance 



whodo is conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 
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write 

writes to another user 

Syntax 

write user [ tty ] 

Description 



write copies lines from your terminal to that of another user. When 
first called, it sends the message: 

Message from your-logname your-tty . . . 

The recipient of the message should write back at this point. Commu- 
nication continues until an end-of-file is read from the terminal or an 
interrupt is sent. At that point, write displays: 

(end of message) 

on the other terminal and exits. 

If you want to write to a user who is logged in more than once, the tty 
argument may be used to indicate the appropriate terminal. 

Permission to write may be denied or granted by use of the mesg(C) 
command. At the outset, writing is allowed. Certain commands, in 
particular nroff(CT) and pr(C), disallow messages in order to prevent 
messy output. 

If the character ! is found at the beginning of a line, write calls the 
shell to execute the rest of the line as a command. 

The following protocol is suggested for using write : when you first 
write to another user, wait for him or her to write back before starting 
to send. Each party should end each message with a distinctive signal 
((o) for “over” is conventional), indicating that the other may reply; 
(oo) for “over and out” is suggested when conversation is to be ter- 
minated. 

Files 



/etc/utmp To find user 

/bin/sh To execute ! 
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WRITE (C) 

See Also 



WRITE (C) 



mail(C), mesg(C), who(C) 

Standards Conformance 



write is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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x286emul 

emulate XENIX 80286 

Syntax 



x286emul [ arg . . . ] prog286 

Description 



x286emul is an emulator that allows programs from XENIX 
System V/286 Release 2.3 or XENIX System V/286 Release 2.3.2 on 
the Intel 80286 to run on the Intel 80386 processor under UNIX 
System V Release 3.2 or later. 

Altos UNIX System V recognizes an attempt to exec(S) a 286 pro- 
gram, and automatically exec's the 286 emulator with the 286 pro- 
gram name as an additional argument. It is not necessary to specify 
the x286emul emulator on the command line. The 286 programs can 
be invoked using the same command format as on the XENIX 
System V/286. 

x286emul reads the 286 program’s text and data into memory and 
maps them through the LDT (via sysi86(S)) as 286 text and data seg- 
ments. It also fills in the jam area, which is used by XENIX programs 
to do system calls and signal returns. x286emul starts the 286 program 
by jumping to its entry point. 

When the 286 program attempts to do a system call, x286emul takes 
control. It does any conversions needed between the 286 system call 
and the equivalent 386 system call, and performs the 386 system call. 
The results are converted to the form the 286 program expects, and the 
286 program is resumed. 

The following are some of the differences between a program running 
on a 286 and a 286 program using x286emul on a 386: 

Attempts to unlink or write on the 286 program will fail on the 286 
with ETXTBSY. Under x286emul , they will not fail. 

ptrace(S) is not supported under x286emul . 

The 286 program must be readable for the emulator to read it. 
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X286EMUL(C) X286EMUL(C) 

Files 



/bin/x286emul 

The emulator must have this name and be in /bin if it is to be 
automatically invoked when exec(S) is used on a 286 program. 
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xargs 

constructs and executes commands 

Syntax 

xargs [ flags ] [ command [ initial-arguments J ] 

Description 



xargs combines the fixed initial-arguments with arguments read from 
the standard input to execute the specified command one or more 
times. The number of arguments read for each command invocation 
and the manner in which they are combined are determined by the 
flags specified. 

Command, which may be a shell file, is searched for using the shell 
$PATH variable. If command is omitted, /bin/echo is used. 

Arguments read in from standard input are defined to be contiguous 
strings of characters delimited by one or more blanks, tabs, or new- 
lines; empty lines are always discarded. Blanks and tabs may be 
embedded as part of an argument if escaped or quoted: Characters 
enclosed in quotes (single or double) are taken literally, and the de- 
limiting quotes are removed. Outside of quoted strings, a backslash (\) 
will escape the next character. 

Each argument list is constructed starting with the initial-arguments , 
followed by some number of arguments read from standard input 
(exception: see -i flag). Flags -i, -1, and -n determine how arguments 
are selected for each command invocation. When none of these flags 
are coded, the initial-arguments are followed by arguments read con- 
tinuously from standard input until an internal buffer is full, and com- 
mand is executed with the accumulated args. This process is repeated 
until there are no more args. When there are flag conflicts (e.g., -1 vs. 
-n), the last flag has precedence. Flag values are: 

Anumber Command is executed for each number lines of 
nonempty arguments from the standard input. This is 
instead of the default single line of input for each com- 
mand, The last invocation of command will be with 
fewer lines of arguments if fewer than number remain. 
A line is considered to end with the first newline unless 
the last character of the line is a blank or a tab; a trail- 
ing blank/tab signals continuation through the next 
nonempty line. If number is omitted, 1 is assumed. 
Option -X is forced. 
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XARGS (C) 



Areplstr 



•nnumber 



-t 



-P 



-X 



-ssize 



-‘teofstr 



Insert mode: command is executed for each line from 
the standard input, taking the entire line as a single arg, 
inserting it in initial-arguments for each occurrence of 
replstr. A maximum of 5 arguments in initial- 
arguments may each contain one or more instances of 
replstr. Blanks and tabs at the beginning of each line 
are thrown away. Constructed arguments may not grow 
larger than 255 characters, and option -x is also forced. 
{ } is assumed for replstr if not specified. 

Executes command , using as many standard input 
arguments as possible, up to the number of arguments 
maximum. Fewer arguments are used if their total size 
is greater than size characters, and for the last invoca- 
tion if there are fewer than number arguments remain- 
ing. If option -X is also coded, each number of argu- 
ments must fit in the size limitation, or xargs ter- 
minates execution. 

Trace mode: The command and each constructed argu- 
ment list are echoed to file descriptor 2 just prior to 
their execution. 

Prompt mode: The user is prompted whether to execute 
command at each invocation. Trace mode (-t) is turned 
on to display the command instance to be executed, fol- 
lowed by a ?... prompt. A reply of y (optionally fol- 
lowed by anything), will execute the command; any- 
thing else, including a carriage return, skips that partic- 
ular invocation of command. 

Causes xargs to terminate if any argument list would 
be greater than size characters; -x is forced by the 
options -i and -1. When neither of the options -i, -1, or 
-n are coded, the total length of all arguments must be 
within the size limit. 

The maximum total size of each argument list is set to 
size characters; size must be a positive integer less than 
or equal to 470. If -s is not coded, 470 is taken as the 
default. Note that the character count for size includes 
one extra character for each argument and the count of 
characters in the command name. 

Eofstr is taken as the logical end-of-file string. Under- 
score (_) is assumed for the logical EOF string if -e is 
not coded, -e with no eofstr coded turns off the logical 
EOF string capability (underscore is taken literally). 
xargs reads standard input until either end-of-file or the 
logical EOF string is encountered. 
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xargs terminates if it either receives a return code of -1 from, or if it 
cannot execute, command. When command is a shell program, it 
should explicitly exit (see sh(C)) with an appropriate value to avoid 
accidentally returning with -1. 

Examples 



The following will move all files from directory $1 to directory $2, 
and echo each move command just before doing it: 

Is $1 I xargs -i -t mv $l/{ } $2/{ } 

The following will combine the output of the parenthesized com- 
mands onto one line, which is then echoed to the end of file log: 

(logname; date; echo $0 $*) I xargs »log 

The user is prompted to enter which files in the current directory are to 
be printed and prints them one at a time: 

Is I xargs -p -1 Ipr 

Or many at a time: 

Is I xargs -p -1 I xargs Ipr 

The following will execute diff(C) with successive pairs of arguments 
originally entered as shell arguments: 

echo $* I xargs -n2 diff 

Standards Conformance 



xargs is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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xprcat 

use transparent printer over modem line 

Syntax 

xprcat [-bf] [file] ... 

Description 



The xprcat utility “transparently” prints files over modeni lines. The 
modem port must have an entry in the xprtabfF) file. Entries may be 
made in the xprtab file using /?cw(ADM). The TERM environment 
variable must be set to a valid terminfo(M) terminal name that sup- 
ports the mc5 (printer_on) and mc4 (printer_off) terminfo(M) capabil- 
ities. Only one xprcat request per modem port may be posted at a 
time. 

If no input file is given, or if a single dash (-) is given, xprcat reads 
from the standard input. The process ID of the xprcat job is printed on 
the standard output. The process ID may be used to kill the tran- 
sparent print request. The options are: 

-b A formfeed is printed before the first file. 

-f A formfeed is printed after each file. 

Files 



/etc/xprtab 

/dev/xpr/xpr* 

/dev/tty* 

See Also 



pcu(ADM), xprsetup(ADM), xprtab(F) 

Value Added 



xprcat is an extension of AT&T System V provided by Altos UNIX 
System V. 
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xtod 

change file format from UNIX to MS-DOS 
Syntax 



xtod [filename] > [output.file] 

Description 



The xtod command converts a file from UNIX format to MS-DOS for- 
mat. The MS-DOS files terminate a line of text with a carriage return 
and a linefeed, while UNIX files terminate a line with a linefeed only. 
Also MS-DOS places a (CTL)z at the end of a file, while UNIX does 
not. Some programs and utilities are sensitive to this difference and 
some are not. If a text or data file is not being interpreted correctly, 
use the dtox and xtod conversion utilities. The xtod command adds 
the extra carriage return to the end of each line and adds the (CTL)z to 
the end of the file. This utility is not required for converting binary 
object files. 

If no filename is specified on the command line, xtod takes input from 
standard input. Output of the utility goes to standard output. 

See Also 



dtox(C) 



J 
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yes 

prints string repeatedly 

Syntax 

yes [ String ] 

Description 



yes repeatedly outputs “y”, or if a single string argument is given, arg 
is output repeatedly. The command will continue indefinitely unless 
aborted. Useful in pipes to commands that prompt for input and 
require a “y” response for a yes. In this case, yes terminates when 
the command it pipes to terminates, so that no infinite loop occurs. 
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V/386 ! 

I 

CM) Miscellaneous 




Contents 



Miscellaneous (M) 



Intro 


introduction to miscellaneous features and files 


aom 


Altos Office Manager Menu System 


ascii 


map of the ASCII character set 


chrtbl 


create a ctype locale table 


clone 


open any minor device on a STREAMS driver 


coltbl 


create a collation locale table 


console 


system console device 


cvtcofF 


convert 386 COFF files to XENIX format 


cvtomf 


convert XENIX files to UNIX COFF format 


daemon.mn 


micnet mailer daemon 


environ 


the user environment 


error 


kernel error output device 


fcntl 


file control options 


fconvert 


create form file 


getclk 


gets string from real-time clock 


getty 


sets terminal type, modes, speed, and line discipline 


init, telinit 


process control initialization 


isverify 


verifies ISAM database records 


jagent 


host control of windowing terminal 


layers 


protocol used between host and windowing terminal 
under layers(C) 


Id 


invokes the link editor 


locale 


the international locale 


log 


interface to STREAMS error logging and event 
tracing 


login 


gives access to the system 


mapchan 

mapkey, 

mapscrn, mapstr, 


configure tty device mapping 


convkey 


configure monitor screen mapping 


math 


math functions and constants 


mconvert 


compile menu into AOM 


messages 


description of system console messages 


mestbl 


create a messages locale table 


montbl 


create a currency locale table 


mscreen 


serial multiscreens utility 


multiscreen 


multiple screens (device files) 



1 




numtbl 


create a numeric locale table 


powerfail 


perform power failure shutdown service 


prof 


profile within a function 


profile 

promain, 


sets up an environment at login time 


nopromain 


restrict the execution domain of a program 


restart 


perform power failure recovery service 


rmb 


remove extra blank lines from a file 


streamio 


STREAMS ioctl commands 


subsystem 


security subsystem component description 


sxt 


pseudo-device driver 


systty 


system maintenance device 


term 


conventional names for terminals 


terminals 


list of supported terminals 


terminfo 


terminal capability data base 


termio 


general terminal interface 


termios 


POSIX general terminal interface 


timod 


Transport Interface cooperating STREAMS module 


timtbl 


create a time locale table 


tirdwr 


Transport Interface read/write interface STREAMS 
module 


trchan 


translate character sets 


tty 


special terminal interface 


tz 


time zone environment variable 


values 


machine-dependent values 


xtproto 


multiplexed channels protocol used by xt(HW) driver 
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Intro 

introduction to miscellaneous features and files 

Description 



This section contains miscellaneous information useful in maintaining 
the system. Included are descriptions of files, devices, tables and pro- 
grams that are important in maintaining the entire system. 
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aom 

Altos Office Manager Menu System 

Syntax 



aom 

Description 



The Altos Office Manager Menu System (referred to as AOM) pro- 
vides a user-friendly interface to applications (such as Uniplex and 
Informix) and specific system utilities (such as creating directories, 
backing up files, and listing files). 

When you enter AOM, you will see four squares containing menus for 
the applications and utilities that are installed on your system. You 
will also see three lines of information about the menus. 

If you have installed an application with an AOM menu, you can link 
the menu into the AOM by using the add command on the Menu Man- 
ager Screen. 

For more details see Altos manual Using the AOM Menu System, part 
number 690-238 14-JCXX. 

Files 



/usr/aom/AOMcap 

/usr/aom/aomtext 

/usr/aom/aom.msgs 

/usr/aom/defupdate 

/usr/aom/form .format 

/usr/aom/form .recover 

/usr/aom/aomnames 

/usr/aom/aomplanes 

/usr/aom/creatext 

/usr/aom/form .archive 

/usr/aom/form.fsck 

/usr/aom/setmsg 

See Also 



fconvert(M), mconvert(M) 
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ascii 

map of the ASCII character set 

Description 



ascii is a map of the 7-bit ASCII character set. It lists both octal and 
hexadecimal equivalents of each character. It contains: 



Octal 


000 nul 


001 soh 


002 stx 


003 etx 


004 eot 


005 enq 


006 ack 


007 bel 


010 bs 


Oil ht 


012 nl 


013 vt 


014 np 


015 cr 


016 so 


017 si 


020 die 


021 del 


022 dc2 


023 dc3 


024 dc4 


025 nak 


026 syn 


027 etb 


030 can 


031 em 


032 sub 


033 esc 


034 fs 


035 gs 


036 rs 


037 us 


040 sp 


041 ! 


042 " 


043 # 


044 $ 


045 % 


046 & 


047 - 


050 ( 


051 ) 


052 * 


053 + 


054 , 


055 - 


056 . 


057 / 


060 0 


061 1 


062 2 


063 3 


064 4 


065 5 


066 6 


067 7 


070 8 


071 9 


072 : 


073 ; 


074 < 


075 = 


076 > 


077 ? 


100 @ 


101 A 


102 B 


103 C 


104 D 


105 E 


106 F 


107 G 


110 H 


111 I 


112 J 


113 K 


114 L 


115 M 


116 N 


117 0 


120 P 


121 Q 


122 R 


123 S 


124 T 


125 U 


126 V 


127 W 


130 X 


131 Y 


132 Z 


133 [ 


134 \ 


135 ] 


136 ^ 


137 _ 


140 - 


141 a 


142 b 


143 c 


144 d 


145 e 


146 f 


147 g 


150 h 


151 i 


152 j 


153 k 


154 1 


155 m 


156 n 


157 0 


160 p 


161 q 


162 r 


163 s 


164 t 


165 u 


166 V 


167 w 


170 X 


171 y 


172 z 


173 { 


174 1 


175 } 


176 " 


177 del 



Hexadecimal 


00 nul 


01 soh 


02 stx 


03 etx 


04 eot 


05 enq 


06 ack 


07 bcl 


08 bs 


09 ht 


Oa nl 


Ob vt 


Oc np 


Od cr 


Oe so 


Of si 


10 die 


11 del 


12 dc2 


13 dc3 


14 dc4 


15 mik 


16 syn 


17 etb 


18 can 


19 em 


la sub 


lb esc 


Ic fs 


Id gs 


le rs 


If us 


20 sp 


21 ! 


22 " 


23 # 


24 $ 


25 % 


26 & 


27 ' 


28 ( 


29 ) 


2a * 


2b + 


2c , 


2d - 


2e . 


2f / 


30 0 


31 1 


32 2 


33 3 


34 4 


35 5 


36 6 


37 7 


38 8 


39 9 


3a : 


3b ; 


3c < 


3d = 


3e > 


3f ? 


40 @ 


41 A 


42 B 


43 C 


44 D 


45 E 


46 F 


47 G 


48 H 


49 I 


4a J 


4b K 


4c L 


4d M 


4e N 


4f 0 


50 P 


51 Q 


52 R 


53 S 


54 T 


55 U 


56 V 


57 W 


58 X 


59 Y 


5a Z 


5b [ 


5c \ 


5d ] 


5e " 


5f _ 


60 ' 


61 a 


62 b 


63 c 


64 d 


65 e 


66 f 


67 g 


68 h 


69 i 


6a j 


6b k 


6c 1 


6d m 


6e n 


6f 0 


70 p 


71 q 


72 r 


73 s 


74 t 


75 u 


76 V 


77 w 


78 X 


79 y 


7a z 


7b { 


7c 1 


7d } 


7e 


7f del 
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The extended 8-bit ASCII character set is shown here, again with the 
octal and hexadecimal value of each character. The mapchan{C) util- 
ity allows access to these characters. Display of these characters is 
dependent on the capabilities of the hardware device. (A ^ indicates 
an unassigned character.) 



Octal 


200 % 


201 ^ 


202 ^ 


203 iS 


204 ind 


205 nel 


206 ssa 


207 esa 


210 hts 


211 htj 


212 vts 


213 pld 


214 plu 


215 ri 


216 ss2 


217 ss3 


220 dcs 


221 pul 


222 pu2 


223 sts 


224 cch 


225 mw 


226 spa 


227 epa 


230 ^ 


231 ^ 


232 fk 


233 csi 


234 St 


235 osc 


236 pm 


237 ape 


240 nbsp 


241 i 


242 0 


243 £ 


244 n 


245 ¥ 


246 1 


247 § 


250 •• 


251 © 


252 * 


253 « 


254 


255 shy 


256 ® 


257 


260 ® 


261 + 


262 * 


263 ’ 


264 ' 


265 n 


266 H 


267 • 


to 

o 


271 * 


272 ° 


273 » 


274 /4 


275 ‘/2 


276 Y4 


277 i 


300 A 


301 A 


302 A 


303 A 


304 A 


305 A 


306 M 


307 g 


310 E 


311 E 


312 E 


313 E 


314 i 


315 I 


316 i 


317 i 


320 D 


321 N 


322 6 


323 6 


324 6 


325 0 


326 O 


327 ^ 


330 0 


331 U 


332 U 


333 U 


334 U 


335 Y 


336 !> 


337 6 


340 h 


341 ^ 


342 a 


343 a 


344 a 


345 X 


346 X 


347 9 


350 b 


351 b 


352 e 


353 b 


354 i 


355 1 


356 i 


357 1 


360 d 


361 fi 


362 6 


363 6 


364 6 


365 0 


366 0 


367 ^ 


370 0 


371 u 


372 u 


373 u 


374 u 


375 y 


376 


377 y 



Hexadecimal 


80 m 


81 m 


82 ^ 


83 ^ 


84 ind 


85 nel 


86 ssa 


87 esa 


88 hts 


89 htj 


8a vts 


8b pld 


8c plu 


8d ri 


8e ss2 


8f ss3 


90 dcs 


91 pul 


92 pu2 


93 sts 


94 cch 


95 mw 


96 spa 


97 epa 


98 ^ 


99 ^ 


9a ^ 


9b csi 


9c St 


9d osc 


9e pm 


9f ape 


aO nbsp 


al 1 


a2 0 


a3 £ 


a4 □ 


a5 ¥ 


a6 1 


a7 § 


a8 ‘ 


a9 © 


aa - 


ab « 


ac 


ad shy 


ae ® 


af 


bO ° 


bl ± 


b2 " 


b3 ' 


b4 ' 


b5 p 


b6 H 


b7 • 


b8 . 


b9 ' 


ba ® 


bb » 


be 


bd 


be M 


bf i 


cO A 


cl A 


c2 A 


c3 A 


c4 A 


c5 A 


c6 JE 


c7 C 


c8 E 


c9 E 


ca e 


cb E 


cc i 


cd I 


ce i 


cf i‘ 


dO D 


dl N 


d2 6 


d3 6 


d4 6 


d5 0 


d6 O 


d7 ^ 


d8 0 


d9 U 


da U 


db U 


dc U 


dd Y 


de I> 


df 6 


eO a 


el a 


e2 a 


e3 a 


e4 a 


e5 a 


e6 X 


e7 9 


e8 b 


e9 e 


ea e 


eb b 


ec 1 


ed 1 


ee i 


ef 1 


fO d 


fl ft 


f2 6 


f3 6 


f4 6 


f5 0 


f6 (5 


a ^ 


f8 0 


f9 u 


fa u 


fb u 


fc ii 


fd y 


fe \i 


ff y 



Files 



/usr/pub/ascii 
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chrtbl 

create a ctype locale table 

Syntax 



chrtbl [ specfile ] 

Description 



The Utility chrtbl is provided to allow new LC_CTYPE locales to be 
defined; It reads a specification file, containing definitions of the 
attributes of characters in a particular character set, and produces a 
binary table file, to be read by setlocale (S), which determines the 
behavior of the ctype (S) and conv(S) routines. 

The information supplied in the specification file consists of lines in 
the following format: 

char type conv 

The three fields, which are separated by space or tab characters, have 
the following meanings and syntax: 

char This is the character which is being defined. It may be 
specified in one of six different ways (the following exam- 
ples all specify the ASCII character “A”): 



65 


decimal 


0101 


octal 


0x41 


hexadecimal 


’A’ 


quoted character 


Mor 


quoted octal 


^x4r 


quoted hexadecimal 



type This specifies the classification of the character, as reported 



by the ctype (S) routines. There are 7 basic classifications: 



C 


iscntrl 




D 


sdigit 




L 


islower 




P 


ispunct 




S 


isspace 
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U isupper 
X isxdigit 



CHRTBL(M) 



Other ctype macros use combinations of these 7 basic 
classifications. Zero, one or more of these classification 
letters can be specified, in any order, although only certain 
combinations are logically reasonable, as follows: 



c 


control character 


cs 


spacing control character 


u 


uppercase alphabetic 


ux 


uppercase alphabetic hex digit 


UL 


dual case character 


L 


lowercase alphabetic 


LX 


lowercase alphabetic hex digit 


DX 


decimal and hex digit 


S 


spacing character 


P 


punctuation (all other printing chars) 


blank 


undefined (all classifications false) 



conv This optional field specifies the corresponding upper case 
character for a lower case character, or the corresponding 
lower case character for an upper case character. Dual- case 
characters should have their own values repeated in this 
field. 

The syntax is as for the char field. 

All characters following a hash (#) are treated as a comment and 
ignored up to the end of the line, unless the hash is within a quoted 
character. 

The initial LC_CTYPE table used is that for the ascii (M) character set, 
with the entries for the higher 128 characters (0x80 - Oxff) set to zero 
(i.e. all classifications false). Thus an empty specification file will 
result in a table for US ASCII . Any specifications found in the inpu^ 
to chrtbl will overwrite the specifications for that character only, thu5 
additions and modifications to the ASCII table can be made without 
respecifying those characters which are unchanged. 

The binary table output is placed in a file named ctype, within the 
current directory. This file should be copied or linked to the correct 
place in the set locale file tree (see locale (M)). To prevent accidental 
corruption of the output data, the file is created with no write permis- 
sion; if the chrtbl utility is run in a directory containing a write- 
protected “ctype” file, the utility will ask if the existing file should be 
replaced; any response other than “yes” or “y” will cause chrtbl to 
terminate without overwriting the existing file. 
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If the spec file argument is missing, the specification information is 
read from the standard input. 

Diagnostics 



If the input table file cannot be opened for reading, processing will ter- 
minate with the error message, “Cannot open specification file”. 

Any lines in the specification file which are syntactically incorrect 
will cause an error message to be issued to the standard error output, 
specifying the line number on which the error was detected. The line 
will be ignored, and processing will continue. 

If the output file, “ctype”, cannot be opened for writing, processing 
will terminate with the error message, “Cannot create table file.” 

Any error conditions encountered will cause the program to exit with 
a non-zero return code; successful completion is indicated with a zero 
return code. 

Specification Fiie Format 



The chrtbl specification file has the following format (the order of the 
specifications is not significant): 

# 

# chrtbl file for TVI 7-bit Spanish character set 

# Note that only non-ASCII characters need be specified 

# 

'0' P 

' [' L 

' W' P 

']' U 

' P 

Fiies 



# inverted ? 

' ] ' # n tilde 

# inverted ! 

' [' # N tilde 

# degree sign 



/usr/include/ctype.h 

See Aiso 



ascii(M), conv(S), ctype(S), locale(M), setlocale(S) 

Vaiue Added 



chrtbl is an extension of AT&T System V provided in Altos UNIX 
System V. 
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clone 

open any minor device on a STREAMS driver 

Description 



clone is a STREAMS software driver that finds and opens an unused 
minor device on another STREAMS driver. The minor device passed 
to clone during the open is interpreted as the major device number of 
another STREAMS driver for which an unused minor device is to be 
obtained. Each such open results in a separate stream to a previously 
unused minor device. 

The clone driver consists solely of an open function. This open func- 
tion performs all of the necessary work so that subsequent system calls 
[including close(S)] require no further involvement of clone, 

clone will generate an ENXIO error, without opening the device, if the 
minor device number provided does not correspond to a valid major 
device, or if the driver indicated is not a STREAMS driver. 

Warnings 



Multiple opens of the same minor device cannot be done through the 
clone interface. Executing stat{S) on the file system node for a cloned 
device yields a different result from executing fstat(S) using a file 
descriptor obtained from opening the node. 

See Also 



log(M) 

STREAMS Programmer's Guide 
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coltbl 

create a collation locale table 

Syntax 



coltbl [ specfile ] 

Description 



The utility coltbl is provided to allow LC_COLLATE locales to be 
defined. It reads in a specification file (or standard input if specfile is 
not defined), containing defintions for a particular locale’s collation 
ordering, and produces a concise format table file, to be read by 
setlocale{S). 

In general, characters may be specified in one of six different ways 
(the following examples all specify the ASCII character “A”): 



65 


decimal 


0101 


octal 


0x41 


hexadecimal 


’A’ 


quoted character 


Mor 


quoted octal 


’\x41’ 


quoted hexadecimal 



The information in the specification file is to an extent free format. A 
particular type of definition is started by one of the following key- 
words: 



PRIM: 

ZERO: 

EQUIV: 

DOUBLE: 

The keywords, PRIM:, ZERO: and EQUIV:, are concerned directly with 
the setting of the collation ordering of characters 

A group of characters which are to be collated as equal, unless all 
other characters in a pair of strings are also equal, are grouped 
together with the PRIM: keyword. The position of a particular group in 
the specification file is significant as far as the collation ordering is 
concerned. Collating elements following the PRIM: keyword are 
separated by white spaces. A two character collating element can be 
specified here by (a b), where a and b are the two characters making 
up the sequence. The order of the collating elements defined in one 
group is significant in secondary collation ordering. It is also possible 
to define a range of characters, for example: 
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PRIM: ’a’ - ’z’ 

Collating elements following the ZERO: keyword, are to be ignored 
when collating. The format of the definitions is the same as with 
PRIM: . Ranges of characters can also be defined, as for example: 

ZERO: 0x80 - 0x9f 

EQUIV: is used to give two collating elements identical positions in 
the collation ordering. The syntax is: 

EQUIV: a = b 

where a and b are the two equal collating elements. There can be only 
one definition for each occurrence of this keyword. 

Single characters which are to be collated as two characters, for exam- 
ple the German sharp s, are defined with the DOUBLE: keyword. The 
syntax is: 



DOUBLE: a = (b c) 

where a is the single character, and b and c are the two characters in 
the collating sequence. There can be only one definition for each oc- 
currence of this keyword. The single character a must not also appear 
after a PRIM: , a ZERO: or a EQUIV: keyword. 

All characters following the hash character are treated as a comment 
and ignored up to the end of the line, unless the hash is within a 
quoted string. 

The concise format locale table is placed in a file named collate in the 
current directory. This file should be copied or moved to the correct 
place in the setlocale (S) file tree (see locale (M)). To prevent acciden- 
tal corruption of the output data, the file is created with no write per- 
mission; if the coltbl utility is run in a directory containing a write- 
protected collate file, the utility will ask if the existing file should be 
replaced - any response other than “yes” or “y” will cause coltbl to 
terminate without overwriting the existing file. 

See Also 



chrtbl(M), collation(S), locale(M), numtbl(M), mestbl(M), montbl(M), 
timtbl(M), setlocale(S) 

Diagnostics 



All error messages printed are self explanatory. 
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Value Added 



COLTBL(M) 



coltbl is an extension of AT&T System V provided in Altos UNIX Sys- 
tem V. 
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console 

system console device 

Description 



The file /dev/console is the device used by the system administrator 
for system maintenance (single-user) operations. It is the tty to which 
the first default shell is attached. 

The system console device can be either a terminal (a serial adapter 
device, tty la) or a sytem keyboard display adapter monitor (ttyOl). 

Many programs, such as the Altos UNIX System V kernel, redirect 
error messages to /dev/console. Initially /dev/console is linked to 
/dev/systty. 

Files 



/dev/console 

See Also 



boot(HW), screen (HW), systty(M), tty(M) 

Notes 



/dev/console should not be enabled, instead either the the display 
adapter (ttyOl) or the serial adapter device (tty la) should be enabled. 

A serial console cannot be attached to a multiport card or one that 
uses special drivers; it must be on a standard COMl card. 

Standards Conformance 



console is conformant with: 

The X/Open Portability Guide II of January 1987. 
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cvtcoff 

convert 386 COFF files to XENIX format 
Syntax 

cvtcoff [ -V ] [ -o outfile ] coff-file 

Description 



cvtcoff converts 386 Common Object Format Files (COFF) to the ap- 
propriate XENIX file format. If the file specified is a relocatable 
object module it is converted to Microsoft OMF format. If it is an 
executable binary it is converted to x.out format. 

If the file is a UNIX System V archive, it is converted to XENIX 
archive format and each file in the archive is converted as appropriate. 
Any files in the archive which are not in 386 COFF format are copied 
to the new archive unchanged, cvtcoff also creates a XENIX format 
.SYMDEF symbol directory for the new archive. 

Options are: 

-V Verbose mode. The name of each member of an archive is dis- 
played as it is converted. 

-o Output file name. The output file will be named a.out by default 
if no output file name is given. 



Notes 



Only essential symbol table information is converted. Source line 
numbers and additional symbol information for use by the symbolic 
debugger sdb will be ignored. 

Note that cvtcoff only converts 386 COFF files. It is not possible to 
convert 286 COFF files. 

Flies 



X.out Default output file 

See Also 



cvtomf(M), 86rel(F), a.out(F), ar(F) 
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Value Added 



CVTCOFF (M) 



cvtcoff is an extension of AT&T System V provided in Altos UNIX 
System V. 
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cvtomf 

convert XENIX files to UNIX COFF format 
Syntax 

cvtomf omf-file 

Description 



cvtomf converts XENIX file format to 386 Common Object Format 
Files (COFF). If the file specified is a relocatable object module it is 
converted to COFF format. 

Notes 



Note that cvtomf only converts 386 XENIX files. It is not possible to 
convert 286 XENIX files. 

Be sure and consult the XENIX Compatibility Guide for possible pit- 
falls relating to file conversion. 

See Aiso 



cvtcoff(M), 86rel(F), a.out(F), ar(F), cc(CP) 

Vaiue Added 



cvtomf is an extension of AT&T System V provided in Altos UNIX 
System V. 



March 1 2, 1 990 



CVTOMF-1 









DAEMON.MN (M) 



DAEMON.MN (M) 



daemon.mn 

micnet mailer daemon 

Syntax 

/usr/lib/mail/daemon.mn [-ex] 

Description 



The mailer daemon performs the “backend” networking functions of 
the mail, rep, and remote commands by establishing and servicing the 
serial communication link between computers in a Micnet network. 

When invoked, the daemon creates multiple copies of itself, one copy 
for each serial line used in the network. Each copy opens the serial 
line, creates a startup message for the LOG file, and waits for a 
response from the daemon at the other end. The startup message lists 
the names of the machines to be connected, the serial line to be used, 
and the current date and time. If the daemon receives a correct 
response, it establishes the serial link and adds the message “first 
handshake complete” to the LOG file. If there is no response, the dae- 
mon waits indefinitely. 

If invoked with the -x switch, the daemon records each transmission in 
the LOG file. A transmission entry shows the direction of the 
transmission (tx for transmit, rx for receive), the number of bytes 
transmitted, the elapsed time for the transmission (in minutes and 
seconds), and the time of day of the transmission (in hours, minutes, 
and seconds). Each entry has the form: 

direction byte count elapsed time time of day 

The daemon also records the date and time every hour. The date and 
time have the same format as described for the date command. 

If invoked with the -e switch, the daemon records all transmission 
errors in the LCXj file. An error entry shows the cause of the error pre- 
ceded by the name of the daemon subroutine which detected the error. 

The mailer daemon is normally invoked by the start option of the 
netutil command and is stopped by the stop option. 

During the normal course of execution, the mailer daemon uses 
several files in the /usr/spool/micnet/remote directory. These files 
provide storage for LOG entries, commands issued by the remote (C) 
command, and a list of processes under daemon control. 
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Files 

/u s r/1 i b/mai 1/daemon . mn 

/usr/spool/micnet/remote/*/LOG 

/usr/spool/micnet/remote/*/mn 

/usr/spool/micnet/remote/local/mn* 

/usr/spool/micnet/remote/lock 

/usr/spool/micnet/remote/pids 

See Also 

netutil(ADM) 



DAEMON.MN (M) 
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environ 

the user environment 

Description 



The user environment is a collection of information about a user, such 
as login directory, mailbox, and terminal type. The environment is 
stored in special “environment variables,” which can be assigned 
character values, such as names of files, directories, and terminals. 
These variables are automatically made available to programs and 
commands invoked by the user. The commands can then use the 
values to access the user’s files and terminal. 

The following is a short list of commonly used environment variables. 

PATH Defines the search path for the directories containing 

commands. The system searches these directories 
whenever a user types a command without giving a full 
pathname. The search path is one or more directory 
names separated by colons (:). Initially, PATH is set to 
:/bin:/usr/bin. 

HOME Names the user’s login directory. Initially, HOME is set 

to the login directory given in the user’s passwd file 
entry. 

EXINIT Used to set vi options and define vi abbreviations and 
mappings. For Bourne Shell users, the syntax is: 

EXINIT = ’set options^ 

For C-Shell users, the syntax is: 

setenv EXINIT ’set options^ 

For example, a C-Shell user might place the following 
command in $HOME/.cshrc: 

setenv EXINIT ’set wm=24 | map g IG’ 

This would automatically set vi's wrapmargin option to 
24 and would define the “g” key to move to the top of 
the file (just as “G” moves to the bottom of the file). 
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TERM 



TZ 



You can set more than one option with the same set 
command. If you define abbreviations or mappings 
with this environment variable, you must separate the 
abbr and map commands from the set command and 
from each other with a bar ( I ). The function of the bar 
is similar to that of the semicolon that separates com- 
mands on a shell command line. 

If you are defining many customizations, you might 
prefer to use the .exrc file, where each command can be 
listed one per line (see v/(C)). 

Defines the type of terminal being used. This informa- 
tion is used by commands such as more(C) which rely 
on information about the capabilities of the user’s ter- 
minal. The variable may be set to any valid terminal 
name (see terminals (M)) directly or by using the 
tset(C) command. 

Defines time zone information. This information is used 
by date(C) to display the appropriate time. The vari- 
able may have any value of the form: 

xxxnzzzs; start/time^ tndltime 

where xxx is standard local time zone abbreviation (1-9 
characters), n is the standard time zone difference from 
GMT, and may be given as hh:mm:ss 
(hours:minutes:seconds), zzz is the summertime local 
time zone abbreviation of 1-9 characters (if any), s is 
the summertime time zone difference from GMT, and 
may be given as hh:mm:ss (hours:minutes:seconds), 
start and end specify the day to begin and end sum- 
mertime based on one of four rules, and time is the 
time of day the change to or from summertime occurs. 
The rules for specifying start and end are: 

Jn 1 based Julian day n 

n 0 based Julian day n 

Wn.d nih day of week d 

Mm.n.d nih day of week d in month m 

For example: 



EST5:00:00EDT4:00:00;M4.1.0/2:00:00,M10.5.0/2:00:00. 
Refer to the tz(M) manual page for more on TZ. 
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HZ Defines, with a numerical value, the number of clock 

interrupts per second. The value of this variable is 
dependent on the hardware, and configured in the file 
etc/default/login. If HZ is not defined, programs which 
depend on this hertz value, such as /?ro/(CP) and 
times(S), will not run. 

LANG Represents the international locale in the format lan- 

guage territory. codeset . This is used by setlocale (S) 
to establish the default locale on program startup. 

Individual locale-specific functions can be affected independently 
using the following optional environment variables: 

LC_CTYPE Locale affecting character classification routines 
{ctype(S)). 

LC.NUMERIC 

Locale affecting numeric formatting. 

LC_TIME Locale affecting time and date format. 

LC.COLLATE 

Locale affecting collation/sorting sequence. 
LC.MESSAGES 

Locale affecting message language. 

LC.MONETARY 

Locale affecting currency formatting. 

The environment can be changed by assigning a new value to a vari- 
able. An assignment has the form: 

name=value 

For example, the assignment: 

TERM=h29 

sets the TERM variable to the value “h29”. The new value can be 
“exported” to each subsequent invocation of a shell by exporting the 
variable with the export command (see sh(C)) or by using the env(C) 
command. 

You may also add variables to the environment, but you must be sure 
that the new names do not conflict with exported shell variables such 
as MAIL, PSl, PS2, and IFS. Placing assignments in the .profile file is 
a useful way to change the environment automatically before a session 
begins. 
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Note that the environment is made available to all programs as an 
array of strings. Each string has the form: 

name=value 

where the name is the name of an exported variable and the value is 
the variable’s current value. For programs started with a exec(S) call, 
the environment is available through the external pointer environ . For 
other programs, individual variables in environment are available 
through getenv{S) calls. 

See Also 



env(C), exec(S), getenv(S) setlocale(S), locale(M), login(M), 
profile(M), sh(C) 

Standards Conformance 



environ is conformant with: 

AT&T SVID Issue 2, Select Code 307>127; 

IEEE POSIX Std 1003.1-1988 with C Standard Language-Dependent 
System Support; 
and NIST FIPS 151-1. 
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error 

kernel error output device 

Description 



System error messages are collected and made available to error log- 
ging daemons through the /dev/error device, /dev/error is a read- 
only device which returns one error per read and no EOF character. 
The /etc/rc2 scripts use a utility to read messages from /dev/error and 
write them to the system error log file /usr/adm/messages: 

/etc/logger /dev/error /usr/adm/messages & 

Any process can read /dev/error or arrange to be signaled when errors 
are queued in /dev/error. The following ioctl causes the error device 
to signal the process with SIGUSRl when an error message is queued 
in /dev/error. 

#include <signal.h> 

#include <sys/eio.h> 

#include <fcntl.h> 

int fd; 

fd = open (” /dev/error”, 0_RD0NLY) ; 
ioctl (fd, EMSG_SIG, SIGUSRl); 

Before exiting, the process must return /dev/error to its normal state. 
Do this with the following ioctl: 



ioctl (fd,EMSG_NOSIG, 



0 ) ; 



Panic error messages are not logged in /dev/error. 

Files 



/dev/error 

See Also 



messages(M) 
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fcnti 

file control options 

Syntax 



#include <fcntl.h> 

Description 



The fcnti (S) function provides for control over open files. This 
include file describes requests and arguments io fcnti and open(S). 

/* Flag values accessible to open(S) and fcnti (S) */ 

/* (The first three can only be set by open) */ 



tdefine OJTONLY 


0 






#define 0J"JFO4LY 


1 






#define 0_RDWR 


2 






#define OJOELAY 


04 


/♦ 


Non-blocking I/O ♦/ 


#define 0_APPEND 


010 


/* append (writes guaranteed at the end) */ 


#define 0_SYNC 


020 


/* synchronous write option */ 


/* Flag values accessible only to open(S) */ 


#define 0_CREAT 


00400 


/♦ 


open with file create (uses third open arg)*/ 


#define OJTRUNC 


01000 


/♦ 


open with truncation */ 


#define 0_EXCL 


02000 


/* 


exclusive open */ 


/* fcnti (S) requests */ 






#define FJDUPFD 


0 


/* 


Duplicate fildes */ 


#define F GETFD 


1 


/* 


Get fildes flags */ 


#define F_SETFD 


2 


/* 


Set fildes flags */ 


#define FjGETFL 


3 


/♦ 


Get file flags */ 


#define F_SETFL 


4 


/♦ 


Set file flags */ 


#define FJ3ETLK 


5 


/♦ 


Get file lock */ 


#define F_SETLK 


6 


/♦ 


Set file lock ♦/ 


#define F_SETLKW 7 


/♦ 


Set file lock and wait */ 


#define F_CHKFL 


8 


/* 


Check legality of file flag changes */ 



/* file segment locking control structure */ 
struct flock { 

short l_type; 
short Ijwhence; 
long l_start; 

long l_len; /* if 0 then until EOF */ 

short l_sysid; /* returned with FJoETLK*/ 

short l_pid; /* returned with FJ3ETLK*/ 

} 
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/* file segment locking types */ 

#define F_RDLCK 01 /* Read lock ♦/ 

#define F_WRLCK 02 /♦ Write lock ♦/ 

#define FJLJNLCK 03 /♦ Remove locks */ 



See Also 

fcntl(S), open(S) 

Standards Conformance 



fcntl is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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(convert 

create form file 
Syntax 



fconvert input_file output_file 

Description 



If you used a form command in your menu file, you must create a form 
file. 

The fconvert command is used for compiling a form file into an AOM 
form file. The input_file is the path and file name of a form file, and 
the output_file is the path and file name of the compiled AOM form 
file that can be integrated to AOM Menu System. 

For more details see Altos manual AOM Tool Kit User's Guide, part 
number 690-17464-xxx. 

Files 



/usr/aom/AOMcap 

/usr/aom/aomtext 

/usr/aom/aom.msgs 

/usr/aom/defupdate 

/usr/aom/form.format 

/usr/aom/form.recover 

/usr/aom/aomnames 

/usr/aom/aomplanes 

/usr/aom/creatext 

/usr/aom/form.archive 

/usr/aom/form.fsck 

/usr/aom/setmsg 

See Also 



aom(M), mconvert(M) 
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getclk 

gets string from real-time clock 

Syntax 

/etc/getclk 

Description 



getclk get a string suitable for date{C) from the real-time clock and 
write it to stdout. Exit code 1 if it doesn’t work, 0 if successful. 

See Also 



date(C) 
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getty 

sets terminal type, modes, speed, and line discipline 

Syntax 

/etc/getty [ -h ] -g ] [ -b blanktime ] [ -t timeout ] line [ speed [ type 
[ linedisc ] ] ] 

/etc/getty -c file 

Description 

getty is a program that is invoked by m/7(M). It is the second process 
in the series, (init-getty-login-shell ), that ultimately connects a user 
with the UNIX system. Initially getty displays the login message field 
for the entry it is using from /etc/gettydefs. getty reads the user’s log- 
in name and invokes the login(M) command with the user’s name as 
argument. While reading the name, getty attempts to adapt the system 
to the speed and type of terminal being used. 

Line is the name of a tty line in /dev to which getty is to attach itself. 
getty uses this string as the name of a file in the /dev directory to open 
for reading and writing. The -t flag, plus timeout in seconds, specifies 
that getty should exit if the open on the line succeeds and no one 
enters anything in the specified number of seconds. The optional 
second argument, speed, is a label to a speed and tty definition in the 
file /etc/gettydefs. This definition tells getty what speed to initially 
run, what the login message should look like, what the initial tty set- 
tings are, and what speed to try next should the user indicate that the 
speed is inappropriate (by entering a BREAK character). The default 
speed is 9600 baud. 

Type , the optional third argument, is a character string describing to 
getty what type of terminal is connected tb the line in question, getty 
recognizes the following types: 

none default 

ds40-l DATASPEED terminal 40/1 

tektronix,tek TEKTRONIX 

vt61 Digital Equipment vt61 

vtlOO Digital Equipment vtlOO 

hp45 Hewlett-Packard 45 

clOO Concept 100 

The default terminal is none; i.e., any crt or normal terminal unknown 
to the system. For terminal type to have any meaning, the virtual ter- 
minal handlers must be compiled into the operating system. They are 
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available, but not compiled in the default condition. The optional 
fourth argument, linedisc , is a character string describing which line 
discipline to use in communicating with the terminal. Again the 
hooks for line disciplines are available in the operating system but 
there is only one presently available, the default line discipline, 
LDISCO. 

If the -g option is invoked, getty will use the GIF viewer to display the 
file /usr/lib/gif/default.gif on the specified terminal. The GIF viewer 
is a program that displays GIF format picture files. The program 
always displays the default.gif file. Common practice is to keep a 
library of GIF pictures in /usr/lib/gif and to simply link the desired 
GIF file to default.gif to have it displayed by the viewer on lines set 
with getty -g. This option is intended for use on an a virtual terminal 
with bit-mapped graphics capability. 

The -b option, too, is useful only only an a virtual terminal. When 
specified with -b, getty will cause the screen to “blank” if nothing is 
typed for blanktime seconds. Pressing any key will re-activate a 
blanked screen. 

When given no optional arguments, getty sets the speed of the inter- 
face to 9600 baud, specifies that raw mode will be used (awaken on 
every character), that echo will be suppressed, either parity allowed, 
that new-line characters will be converted to carriage return-line feed, 
and that tab expansion is performed on the standard output. It displays 
the login message before reading the user’s name a character at a time. 
If a null character (or framing error) is received, it is assumed to be 
the result of the user pushing the BREAK key. This will cause getty to 
attempt the next speed in the series. The series that getty tries is 
determined by what it finds in /etc/gettydefs. 

The user’s name is terminated by a new-line or carriage-return charac- 
ter. The latter results in the system being set to treat carriage returns 
appropriately (see ioctl(S)). 

The user’s name is scanned to see if it contains any lower-case alpha- 
betic characters, getty suggests that the user use all lower-case charac- 
ters. If the user uses upper case characters, the system is told to map 
any future upper-case characters into the corresponding lower-case 
characters. 

Finally, login is exec’d with the user’s name as an argument. Addi- 
tional arguments may be typed after the login name. These are passed 
to login y which will place them in the environment [see login (M)]. 

A check option is provided. When getty is invoked with the -c option 
and fiky it scans the file as if it were scanning /etc/gettydefs and 
prints out the results to the standard output. If there are any unrecog- 
nized modes or improperly constructed entries, it reports these. If the 
entries are correct, it displays the values of the various flags. See 
ioctl(S) to interpret the values. Note that some values are added to the 
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flags automatically. 

Files 



/etc/gettydefs 

/usr/lib/gif/default.gif 

See Also 



init(M), login(M), uugetty(M), tty(HW), ioctl(S), gettydefs(F), 
inittab(F) 

Notes 



While getty understands simple single character quoting conventions, 
it is not possible to quote certain special control characters used by 
getty . Thus, you cannot log in via getty and type I, back- 

space, "'ll, "'D, or & as part of your login name or arguments, getty 
uses them to determine when the end of the line has been reached, 
which protocol is being used, and what the erase character is. They 
will always be interpreted as having their special meaning. 

When connecting two computers using a direct connection, never 
invoke getty (}A) on the ports of both machines. Instead, use 
uugetty (M). 
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init, telinit 

process control initialization 

Syntax 

/etc/init [ 0123456SsQqabc ] 
/bin/telinit [ 0123456SsQqabc ] 

Description 



init is a general process spawner. Its primary role is to create pro- 
cesses from information stored in the file /etc/inittab [see inittabi^)]. 

At any given time, the system is in one of eight possible run levels. A 
run level is a software configuration of the system under which only a 
selected group of processes exist. The processes spawned by init for 
each of these run levels is defined in /etc/inittab. init can be in one of 
eight run levels, 0-6 and S or s (run levels S and s are identical). The 
run level changes when a privileged user runs /etc/init. This user- 
spawned init sends appropriate signals to the original init spawned by 
the operating system when the system was booted, telling it which run 
level to change to. 

If the file /etc/default/boot contains the string MAPKEY=YES, init 
invokes the mapkey program (see mapkey(M)) to map the console key- 
board. If the call to mapkey succeeds, the console is set to 8-bits no 
parity. If the call fails, and the string SERIAL8=YES appears in 
/etc/default/boot, a serial console device is assumed and set to 8-bits 
no parity. 

The following are the arguments to init: 

0 shut the machine down so it is safe to remove the power. 
Have the machine remove power if it can. This state can 
be executed only from the console. 

1 put the system in single-user mode. Unmount all file sys- 
tems except root. All user processes are killed except 
those connected to the console. This state can be exe- 
cuted only from the console. 

2 put the system in multiuser mode. All multiuser environ- 
ment terminal processes and daemons are spawned. This 
state is commonly referred to as the multiuser state. 
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3 Start the remote file sharing processes and daemons. 
Mount and advertise remote resources. Run level 3 
extends multiuser mode and is known as the remote- file- 
sharing state. 

4 This is available to be defined as an alternative multiuser 
environment configuration. It is not necessary for system 
operation and is usually not used. 

5 Stop the UNIX system and go to the firmware monitor. 

6 Stop the UNIX system and reboot to the state defined by 
the initdefault entry in /etc/inittab. 

a,b,c Process only those /etc/inittab entries having the a, b or c 
run level set. These are pseudo-states, which may be 
defined to run certain commands, but which do not cause 
the current run level to change. 

Q,q Re-examine /etc/inittab. 

S,s Enter single-user mode. When this occurs, the terminal 
which executed this command becomes the system con- 
sole (see Notes for more information about console device 
assignment). This is the only run level that doesn’t require 
the existence of a properly formatted /etc/inittab file. If 
this file does not exist, then by default the only legal run 
level that init can enter is the single-user mode. When the 
system enters S or s, all mounted file systems remain 
mounted and only processes spawned by init are killed. 

When a UNIX system is booted, init is invoked and the following 
occurs, init first looks in /etc/default/boot to determine if autoboot 
on panic is desired, init looks to see if DEFAULT_LEVEL=N is 
specified in /etc/default/boot. If it is, then N is the default level, oth- 
erwise, the user is prompted to see if they wish to go to multiuser or 
system maintenance mode (single-user mode). In the single-user 
state, the virtual console terminal is assigned to the user’s terminal 
and is opened for reading and writing. The sulogin command, which 
requires the user to enter the root password, is invoked and a message 
is generated on the physical console saying where the virtual console 
has been relocated. Use either init or telinit to signal init to change 
the run level of the system. Note that if the shell is terminated (via an 
end-of-file), init will only re-initialize to the single-user state if the 
/etc/inittab file does not exist. 

If a 0 through 6 is entered, init enters the corresponding run level. 
Note that, on your computer, the run levels 0, 1, 5, and 6 are reserved 
states for shutting the system down; the run levels 2, 3, and 4 are 
available as normal operating states. 
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If this is the first time since power up that init has entered a run level 
other than single-user state, init first scans /etc/inittab for boot and 
bootwait entries [see inittab(F)]. These entries are performed before 
any other processing of /etc/inittab takes place, providing that the run 
level entered matches that of the entry. In this way, any special ini- 
tialization of the operating system, such as mounting filesystems, can 
take place before users are allowed onto the system, init then scans 
/etc/inittab and executes all other entries that are to be processed for 
that run level. 

In a multiuser environment, /etc/inittab is set up so that init will cre- 
ate a getty process for each terminal that the administrator sets up to 
respawn. 

To spawn each process in /etc/inittab, init reads each entry and for 
each entry that should be respawned, it forks a child process, init 
spawns each process by forking a shell to run the job in. To set up the 
environment for this shell, init uses the /etc/initscript file which con- 
tains the definitions of some global variables, for example, TZ, HZ, 
and PATH. After it has spawned all of the processes specified by 
/etc/inittab, init waits for one of its descendant processes to die, a 
powerfail signal, or a signal from another init or telinit process to 
change the system’s run level. When one of these conditions occurs, 
init re-examines /etc/inittab. New entries can be added to /etc/inittab 
at any time; however, init still waits for one of the above three condi- 
tions to occur before re-examining /etc/inittab. To get around this, an 
init Q or init q command wakes init to re-examine /etc/inittab 
immediately. 

When init comes up at boot time and whenever the system changes 
from the single-user state to another run state, init sets the ioctl(S) 
states of the virtual console to those modes saved in the file 
/etc/ioctl.syscon. This file is written by init whenever the single-user 
state is entered. 

When a run level change request is made, init sends the warning sig- 
nal (SIGTERM) to all processes that are undefined in the target run 
level, init waits 5 seconds before forcibly terminating these processes 
via the kill signal (SIGKILL). 

The shell running on each terminal will terminate when the user types 
an end-of-file or hangs up. When init receives a signal telling it that a 
process it spawned has died, it records the fact and the reason it died 
in /etc/utmp and /etc/wtmp if it exists [see who{C)]. A history of tie 
processes spawned is kept in /etc/wtmp. 

If init receives a powerfail signal (SIGPWR) it scans /etc/inittab for 
special entries of the type powerfail and powerwait . These entries are 
invoked (if the run levels permit) before any further processing takes 
place. In this way init can perform various cleanup and recording 
functions during the powerdown of the operating system. Note that in 
the single-user states, S and s, only powerfail and powerwait entries 
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are executed. If init receives a powerfail signal (SIGPWR) on a warm 
restart of the system after a power failure, it scans /etc/inittab for spe- 
cial entries of the type restart. These entries are invoked, causing 
some processes (e.g., network daemons) to start up. 

telinit , which is linked to /etc/init, is used to direct the actions of init . 
It takes a one-character argument and signals init to take the appropri- 
ate action. 

Files 



/etc/default/boot 

/etc/inittab 

/etc/utmp 

/etc/wtmp 

/etc/ioctl.syscon 

/etc/ini tscript 

/dev/console 

/dev/contty 

See Also 



disable(C), enable(C), login(M), sh(C), stty(C), who(C), getty(M), 
powerfail(M), restart(M), shutdown(M), sulogin(ADM), termio(HW), 
kill(S), gettydefs(F), inittab(F), utmp(F) 

Diagnostics 



If init finds that it is respawning an entry from /etc/inittab more than 
10 times in 2 minutes, it will assume that there is an error in the com- 
mand string in the entry, and generate an error message on the system 
console. It will then refuse to respawn this entry until either 5 minutes 
has elapsed or it receives a signal from a user-spawned init {telinit ). 
This prevents init from eating up system resources when someone 
makes a typographical error in the inittab file or a program is removed 
that is referenced in /etc/inittab. 

When attempting to boot the system, failure of init to prompt for a 
new run level may be because the virtual system console is linked to a 
device other than the physical system console. 
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Notes 



init and telinit can be run only by someone who is super-user. 

The S or s state must not be used indiscriminately in the /etc/inittab 
file. A good rule to follow when modifying this file is to avoid adding 
this state to any line other than the initdefault. 

The assignment of the console device may seem confusing at first. 
Whenever the system is rebooted, the first boot up messages will be 
displayed on the “normal” system console (ttyOl), then the prompt 
for going multiuser will be displayed on the the tty from which init S 
was last invoked, which could be any tty on the system. The system 
console device (/dev/syscon) remains linked to the tty from which the 
last init S is invoked. Rebooting the system does NOT reset this to 
ttyOl. 

If the /etc/initscript file is not present, init will print a warning on the 
console and spawn the job without setting up the global environment. 

The change to /etc/gettydefs described in the Notes section of the 
gettydefs(^) manual page will permit terminals to pass 8 bits to the 
system as long as the system is in multiuser state (run level greater 
than 1). When the system changes to single-user state, the getty is 
killed and the terminal attributes are lost. To permit a terminal to pass 
8 bits to the system in single-user state, after you are in single-user 
state, type: 

stty -istrip cs8 

The /etc/TIMEZONE file must exist, /etc/initscript executes this file 
to set the correct TZ variable for the system. 

Standards Conformance 



init is conformant with: 

AT&TSVID Issue 2, Select Code 307-127. 
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isverify 

verifies ISAM database records 

Syntax 

isverify [ -lilpyn] tablelist 

Description 



isverify detects and, if specified, repairs inconsistencies between 
ISAM data (.dat) files and index (.idx) files. The isverify utility 
checks that every valid record in the data file is properly represented 
in the index file; it also checks that every index entry points to a valid 
data record. 

tablelist is the list of tables to be checked by isverify. The .dat and 
,idx suffixes should not be included in the tablelist. 

Options 



You can specify any of the following flags when invoking isverify: 



-I after a system restore, an ISAM application can fail with 
the message: 

Error: Incorrect SCO Runtime System installed 

You can correct this situation by logging in as root and 
invoking isverify -I. 

-i Check only the index file (as opposed to checking both the 
index and the data files) for consistency. Use this option as 
a quick check if you think the data files are probably not 
corrupted. 

-1 prints a long listing of the information for each defined key 
(index), along with the associated data record pointer. The 
key value for each data record is displayed by key part, 
along with the byte position of the data record in the data 
file. This information is useful only if you understand the 
Indexed Sequential Access Method (ISAM). 

-p pauses after displaying information about each index. If 
you select this option, you must press the Break key before 
the isverify process continues. 
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-y causes isverify to assume a “yes” answer to each error 
state and to attempt to make the specified correction. It is 
recommended that you use this flag so that the isverify util- 
ity attempts to correct any discrepancies automatically. 

-n causes isverify to assume a “no” answer to each error state 
and to leave the files unchanged. It also allows you see 
where errors are by displaying them on the screen. 

Whether or not you use isverify with the -1 or -p flags, if an error is 
detected, you have the option of making a correction or leaving the 
files unchanged. If no errors are detected, no response is required. If 
you choose to make a correction, isverify attempts to repair the files. 
Unless the -y or -n flags are specified on the command line, you must 
choose interactively whether or not to make each correction. 
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jagent 

host control of windowing terminal 
Syntax 

#inciude <sys/jioctl.h> 

ioctl (cntlfd, JAGENT, &arg) 

int cntlfd 
struct bagent arg 

Description 



The ioctl{S) system call, when performed on an jcr(HW) device with 
the JAGENT request, allows a host program to send information to a 
windowing terminal. 

ioctl has three arguments: 

cntlfd the jct(HW) control channel file descriptor 

JAGENT the x/(HW) ioctl(S) request to invoke a windowing termi- 
nal agent routine. 

arg the address of a bagent structure, defined in <sys/jioctl.h> 



as follows: 










struct 


bagent 


{ 








long 


s i z e ; 


/* 


size 


of src in 


& dest out */ 


char 


*src; 


/* 


the 


source byte 


string */ 


char 


*dest ; 


/★ 


the 


destination 


byte string */ 



}; 



The src pointer must be initialized to point to a byte string which is 
sent to the windowing terminal. See layers(}A) for a list of JAGENT 
strings recognized by windowing terminals. Likewise, the dest 
pointer must be initialized to the address of a buffer to receive a byte 
string returned by the terminal. When ioctl(S) is called, the size argu- 
ment must be set to the length of the src string. Upon return, size is 
set by ioctl(S) to the length of the destination byte string, dest. 

See Also 



ioctl(S), libwindows(S), layers(M), xt(HW) 
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Diagnostics 



Upon successful completion, the size of the destination byte string is 
returned. If an error occurs, -1 is returned. 
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layers 

protocol used between host and windowing terminal 
under layers(C) 

Syntax 



#include <sys/jioctl.h> 

Description 



layers are asynchronous windows supported by the operating system 
in a windowing terminal. Communication between the Altos UNIX 
System V processes and terminal processes under layers{C) occurs via 
multiplexed channels managed by the respective operating systems 
using a protocol as specified in xtproto(}A). 

The contents of packets transferring data between an Altos UNIX Sys- 
tem V process and a layer are asymmetric. Data sent from the Operat- 
ing System to a particular terminal process is undifferentiated and it is 
up to the termini process to interpret the contents of packets. 

Control information for terminal processes is sent via channel 0. Pro- 
cess 0 in the windowing terminal performs the designated functions on 
behalf of the process connected to the designated channel. These 
packets take the form: 



command, channel 

except for timeout and jagent information which take the form 



command, data... 

The commands are the bottom eight bits extracted from the following 

ioctl(S) codes: 

JBOOT Prepare to load a new terminal program into the desig- 
nated layer. 

JTERM Kill the downloaded layer program and restore the default 
window program. 

JTIMO Set the timeout parameters for the protocol. The data 
consist of two bytes: the value of the receive timeout in 
seconds and the value of the transmit timeout in seconds. 
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JTIMOM Set the timeout parameters for the protocol. The data 
consist of four bytes in two groups: the value of the 
receive timeout in milliseconds (the low eight bits fol- 
lowed by the high eight bits) and the value of the transmit 
timeout (in the same format). 

JZOMBOOT 

Like JBCX)T, but do not execute the program after loading. 

JAGENT Send a source byte string to the terminal agent routine and 
wait for a reply byte string to be returned. 

The data are from a bagent structure [see jagent(M)] and 
consist of a one-byte size field followed by a two-byte 
agent command code and parameters. Two-byte integers 
transmitted as part of an agent command are sent with the 
high-order byte first. The response from the terminal is 
generally identical to the command packet, with the two 
command bytes replaced by the return code: 0 for success, 
-1 for failure. Note that the routines in the libwindows (S) 
library all send parameters in an agentrect structure. The 
agent command codes and their parameters are as fol- 
lows: 



A_NEWLAYER 


followed by a two-byte channel num- 
ber and a rectangle structure (four 
two-byte coordinates). 


A__CURRENT 


followed by a two-byte channel num- 
ber. 


A^DELETE 


followed by a two-byte channel num- 
ber. 


A__TOP 


followed by a two-byte channel num- 
ber. 


A_BOTTOM 


followed by a two-byte channel num- 
ber. 


A__MOVE 


followed by a two-byte channel num- 
ber and a point to move to (two two- 
byte coordinates). 


A^RESHAPE 


followed by a two-byte channel num- 
ber and the new rectangle (four two- 
byte coordinates). 


A_NEW 


followed by a two-byte channel num- 
ber and a rectangle structure (four 
two-byte coordinates). 
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A EXIT no parameters needed. 

A ROMVERSION no parameters needed. The response 
packet contains the size byte, two- 
byte return code, two unused bytes, 
and the parameter part of the terminal 
id string (e.g., “8;7;3”). 



Packets from the windowing terminal to Altos UNIX System V all take 
the following form; 



command, data... 

The single-byte commands are as follows: 

C SENDCHAR Send the next byte to the UNIX system pro- 

cess. 

Create a new UNIX system process group 
for this layer. Remember the window size 
parameters for this layer. The data for this 
command is in the form described by the 
jwinsize structure. The size of the window 
is specified by two 2-byte integers, sent 
low byte first. 

Unblock transmission to this layer. There 
is no data for this command. 

Delete the UNIX system process group 
attached to this layer. There is no data for 
this command. 

Exit. Kill all UNIX system process groups 
associated with this terminal and terminate 
the session. There is no data for this com- 
mand. 

C^DEFUNCT Layer program has died, send a terminate 

signal to the UNIX system process groups 
associated with this terminal. There is no 
data for this command. 

C_SENDNCHARS The rest of the data are characters to be 
passed to the UNIX system process. 



C_NEW 

C^UNBLK 

C_^DELETE 

C EXIT 
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C_RESHAPE The layer has been reshaped. Change the 

window size parameters for this layer. The 
data takes the same form as for the C NEW 
command. 

See Also 

libwindows(S), jagent(M), xtproto(M), layers(C), xt(HW) 
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Id 

invokes the link editor 

Syntax 



Id [options] filename 

Description 



The Id command combines several object files into one, performs relo- 
cation, resolves external symbols, and supports symbol table informa- 
tion for symbolic debugging. It creates an executable program by 
combining one or more object files and copying the executable result 
to the file a.out. The filename must name an object or library file. By 
convention these names have the “.o” (for object) or “.a” (for 
archive library) extensions. If more than one name is given, the names 
must be separated by one or more spaces. If any input file, filename , 
is not an object file. Id assumes it is either an archive library or a text 
file containing link editor directives. By default, the file a.out is 
excutable if no errors occurred during the load. If errors occur while 
linking. Id displays an error message; the resulting a.out file is unexe- 
cutable. 

Id concatenates the contents of the given object files in the order given 
in the command line. Library files in the command line are examined 
only if there are unresolved external references encountered from pre- 
vious object files. 

The library is searched iteratively to satisfy as many references as 
possible and only those routines that define unresolved external refer- 
ences are concatenated. The library (archive) symbol table (see tzr(F)) 
is searched sequentially with as many passes as are necessary to 
resolve external references which can be satisfied by library members. 
Thus, the ordering of library members is functionally unimportant, 
unless there exist multiple library members defining the same external 
symbol. The library may be either a relocatable archive library or a 
shared library. Object and library files are processed at the point they 
are encountered in the argument list, so the order of files in the com- 
mand line is important. In general, all object files should be given 
before library files. Id sets the entry point of the resulting program to 
the beginning of the first routine. 

Id should be invoked using the cc(CP) command instead of invoking it 
directly, cc invokes Id as the last step of compilation, providing all 
the necessary C-language support routines. Invoking Id directly is not 
recommended since failure to give command line arguments in the 
correct order can result in errors. 
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When Id is called, it scans all the object files that are to be linked. If 
they are all COFF objects, then the resulting bina^ will be in COFF 
format. If any of the object files to be linked are in x.out format, any 
COFF modules in the group will be converted to x.out and the result- 
ing binary will be in x.out format. 

Common Options 



The following options are recognized by Idy and are common to pro- 
ducing both COFF and x.out binaries. Refer to the sections “Linking 
COFF Binaries” and “Linking x.out Binaries” for options specific to 
producing these binaries. 

-o name 

Sets the executable program filename to name instead of a.out. 

-r XENIX VERSION: Invokes the incremental linker, /lib/ldr, with 
the arguments passed to Id to produce a relocatable output file. 

AT&T VERSION: Retains relocation entries in the output object file. 
Relocation entries must be saved if the output file is to become an 
input file in a subsequent Id run. The link editor will not complain 
about unresolved references, and the output file will not be executable. 

-s Strips line number entries and symbol table information from the 
output object file. 

-u symbol 

Designates the specified symbol as undefined. This is useful for 
loading entirely from a library, since initially the symbol table is 
empty and an unresolved reference is needed to force the loading 
of the first routine. The placement of this option on the Id line is 
significant; it must be placed before the library which will define 
the symbol. 

-V Outputs a message giving information about the version of Id being 
used. 

Linking COFF Binaries 



The following options are recognized by Id for linking COFF binaries: 
-e epsym 

Set the default entry point address for the output file to be that of 
the symbol epsym . 
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4fill 

Set the default fill pattern for “holes” within an output section as 
well as initialized bss sections. The argument fill is a two-byte 
constant. 

-Lr Search a library libjc.a, where x is up to nine characters. A library 
is searched when its name is encountered, so the placement of a -1 
is significant. By default, libraries are located in LIBDIR or LLIB- 
DIR. 



-m 

Produce a map or listing of the input/output sections on the stan- 
dard output. 

-a Create an absolute file. This is the default if the -r option is not 
used. Used with the -r option, -a allocates memory for common 
symbols. 

-t Turn off the warning about multiply-defined symbols that are not 
the same size. 

-X Do not preserve local symbols in the output symbol table; enter 
external and static symbols only. This option saves some space in 
the output file. 

-z Do not bind anything to address zero. This option will allow run- 
time detection of null pointers. 

-L dir 

Change the algorithm of searching for libx.a to look in dir before 
looking in LIBDIR and LLIBDIR. This option is effective only if it 
precedes the -1 option on the command line. 



-M 

Output a message for each multiply-defined external definition. 

-N Put the text section at the beginning of the text segment rather than 
after all header information, and put the data section immediately 
following text in the core image. 

-VS num 

Use num as a decimal version stamp identifying the a.out file that 
is produced. The version stamp is stored in the optional header. 

-Y[LU]4ir 

Change the default directory used for finding libraries. If L is 
specified, the first default directory which Id searches, LIBDIR, is 
replaced by dir. If U is specified and Id has been built with a 
second default directory, LLIBDIR, then that directory is replaced 
by dir. If Id was built with only one default directory and U is 
specified a warning is printed and the option is ignored. 
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Linking x.out Binaries 



The user must make sure that the most recent library versions have 
been processed with ranlib{CV) before linking. Library files for x.out 
format binaries must be in ranlib{C^) format, that is, the first member 

must be named .SYMDEF, which is a dictionary for the library. Id 

compares the modification dates of the library and the .SYMDEF 

entry, so if object files have been added to the library since .SYM- 

DEF was created, the link may result in an “invalid object module” 
that cannot run. 

The following options are recognized by Id for linking x.out binaries: 
-A num 

Creates a standalone program whose expected load address (in 
hexadecimal) is num. This option sets the absolute flag in the 
header of the a.out file. Such program files can only be executed as 
standalone programs. Options -A and -F are mutually exclusive. 

-B num 

Sets the text selector bias to the specified hexadecimal number. 

-c num 

Alters the default target CPU in the x.out header, num can be 0, 1, 
2, or 3 indicating 8086, 80186, 80286 and 80386 processors, 
respectively. The default on 8086/80286 systems is 0. The default 
on 80386 systems is 3. Note that this option only alters the default; 
if object modules containing code for a higher numbered processor 
are linked, then that will take precedence over the default. 



■C 

Causes the link editor to ignore the case of symbols. 

-D num 

Sets the data selector bias to the specified hexadecimal number. 

-F num 

Sets the size of the program stack to num bytes where num is a 
hexadecimal number. This option is ignored fof 80386 programs 
which have a variable sized stack. By default 8086 programs have 
a variable stack located at the top of the first data segment, and 
80286 programs have a fixed size 4096 byte stack. The -F option 
is incompatible with the -A option that cannot be opened by more 
than one user at the same time. 

-g Includes symbolic information for sdb. 

-i Creates separate instruction and data spaces for small model pro- 
grams. When the output file is executed, the program text and data 
areas are allocated separate physical segments. The text portion 
will be read-only and shared by all users executing the file. 
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Sets advisory file locking. Advisory locking is used on files with 
access modes that do not require mandatory locking. 



-Lm 

Sets mandatory file locking. Mandatory file locking is used on files 
that cannot be opened by more than one process at a time. 

-m name 

Creates a link map file named name that includes public symbols. 
-Mx 

Specifies the memory model, x can have the following values: 
s small 

m middle 

1 large 

h huge 

e mixed 

-n num 

Truncates symbols to the length specified by num, 

-N num 

Sets the pagesize to hex-nwm (which should be a multiple of 512) - 
the default is 1024 for 80386 programs. 8086/80186/80286 pro- 
grams do not normally have page-aligned x.out files and the default 
for these is 0. 

-P 

Disables packing of segments 

-R Ensures that the relocation table is of non-zero size. Important for 
8086 compatibility. 

-Rd num 

Specify the data segment relocation offset (80386 only), num is 
hexadecimal. 

-Rt num 

Specify the text segment relocation offset (80386 only) num is 
hexadecimal. 

-S num 

Sets the maximum number of segments to num. If no argument is 
given, the default is 128. 
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/bin/ld 




UBDIRI\ihx,2i 


libraries 


LLIBDlRI\\hx.di 


libraries 


a.out 


output file 


LIBDIR 


usually Aib 


LLIBDIR 


usually /usrAib 


See Also 





as(CP), cc(CP), masm(CP), mkshlib(CP), ranlib(CP), exit(S), end(S), 
a.out(F), ar(F). 

Notes 



Through its options and input directives, the common link editor gives 
users great flexibility; however, those who use the input directives 
must assume some added responsibilities. Input directives and options 
should insure the following properties for programs: 

C defines a zero pointer as null. A pointer to which zero has 
been assigned must not point to any object. To satisfy this, users 
must not place any object at virtual address zero in the 
program’s address space. 

When the link editor is called through cc(CP), a startup routine 
is linked with the user’s program. This routine calls exit( ) [see 
exit(S)] after execution of the main program. If the user calls 
the link editor directly, then the user must insure that the pro- 
gram always calls exit( ) rather than falling through the end of 
the entry routine. 

The symbols etext, edata, and end (see end{S)) are reserved and are 
defined by the link editor. It is incorrect for a user program to redefine 
them. 

If the link editor does not recognize an input file as an object file or an 
archive file, it will assume that it contains link editor directives and 
will attempt to parse it. This will occasionally produce an error mes- 
sage complaining about “syntax errors’’. 

Arithmetic expressions may only have one forward referenced symbol 
per expression. 

If you are using XENIX binaries, please refer to the manual entry for 
this utility in the XENIX Development Guide for information on the 
appropriate usage with XENIX binaries. 
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Standards Conformance 



/<i is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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locale 

the international locale 

Syntax 

language [ [ territory ] [ . [ codeset ] ] ] 

"C" 

Description 



The international locale is a definition of the local conventions to be 
used by Altos UNIX System V libraries (and hence utilities and appli- 
cations) for features whose behavior varies internationally. 

The locale is specified by a character string of the form lan- 
guage Jerritory. codeset , where: 

language represents both the language of text files being used, 
and the preferred language for messages (where the 
utility or application is capable of displaying messages 
in many languages), 

territory represents the geographical location (usually the coun- 
try) determining such factors as currency and numeric 
formats, and 

codeset represents the character set in use for the internal 
representation of text. 

The locale string “french_canada.8859” could therefore represent a 
Canadian user using the French language, processing data using the 
ISO 8859/1 standard international character set. 

Each element {language, territory or codeset) can be up to 14 charac- 
ters long, and should use only alphanumeric ASCII characters (see 
ascii(M)). 

Note that the locale is not required to be completely specified: terri- 
tory and codeset are optional. When a locale is incompletely 
specified, missing values are sought in the following sequence: 

1 . For each subclass, such as LC_TIME , in an environment variable 
of the same name as the subclass. 

2. In the LANG environment variable. 
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3. In the file letcldefaultllang . 

The special locale string ^‘C”, used to represent the minimal environ- 
ment needed for the C programming language, is taken to be 
equivalent to “english_us.ascii”. 

The format of the file letcldefaultllang is at least one line, of the form: 
luAY\G=^Hangiiage_territory . codeseC' 

A partly specified locale string will be expanded to the first LANG - 
entry in which the specified locale fields match. 

Thus if the letcldefaultllang file contains the following: 

LANG=english_us . ascii 
LANG=english_uk .8859 
LANG=f rench_france . 8859 

A locale string “english_uk” will get expanded to 
“english_uk.8859”, whereas a locale string “french” will get 
expanded to “french_france.8859”. 

The information used to configure a particular locale is generated by 
the utilities chrtbl(}A), coltbKM), mestbKM), montblQs/L), numtbl(M) 
and timtbKfA). The output files produced by these utilities {ctype , col- 
late, currency, messages, numeric and time respectively) must be 
installed in the correct place in the directory structure lusrilibllang. 
The correct directory name is found by substituting the language, ter- 
ritory and codeset names into the string “/usr/lib/lang//tzn- 
guagelterritoryl codesef \ The files should be installed into this direc- 
tory with their existing file name (such as ctype), 

A suggested naming convention for locales is as follows: 

language The name of the language, in English, such as: english, 
french, german. 

territory The name of the nation, in English, such as: us, uk, 
Canada, france, germany, Switzerland. 

codeset An identification of the codeset, such as: ascii, 8859. 

See Also 



chrtbl(M), coltbl(M), environ(M), mestbl(M), montbl(M), numtbl(M), 
setlocale(S), timtbl(M) 
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locale is an extension of AT&T System V provided in Altos UNIX 
System V. 
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log 

interface to STREAMS error logging and event tracing 

Description 



log is a STREAMS software device driver that provides an interface 
for the STREAMS error logging and event tracing processes 
[^fr^rr(ADM), strace{ADM)]. log presents two separate interfaces: a 
function call interface in the kernel through which STREAMS drivers 
and modules submit log messages; and a subset of ioctl{S) system 
calls and STREAMS messages for interaction with a user level error 
logger, a trace logger, or processes that need to submit their own log 
messages. 



Kernel Interface 

log messages are generated within the kernel by calls to the function 
St r log: 



strlog(mid, sid, level, flags, fmt, argl, ...) 

short mid, sid; 

char level; 

ushort flags; 

char *fmt; 

unsigned argl; 

Required definitions are contained in <sys/strlog.h> and <sys/log.h>. 
mid is the STREAMS module id number for the module or driver sub- 
mitting the log message, sid is an internal sub-id number usually used 
to identify a particular minor device of a driver, level is a tracing 
level that allows for selective screening out of low priority messages 
from the tracer, flags are any combination of SL_ERROR (the mes- 
sage is for the error logger), SL_TRACE (the message is for the tracer), 
SL_FATAL (advisory notification of a fatal error), and SL_NOTIFY 
(request that a copy of the message be mailed to the system adminis- 
trator). fmt is a printfiS) style format string, except that %s, %e, %E, 
%g, and %G conversion specifications are not handled. Up to NLO- 
GARGS (currently 3) numeric or character arguments can be provided. 



User Interface 

log is opened via the clone interface, /dev/log. Each open of /dev/log 
obtains a separate stream to log. In order to receive log messages, a 
process must first notify log whether it is an error logger or trace 
logger via a STREAMS I_STR ioctl call (see below). For the error 
logger, the I_STR ioctl has an ic_cmd field of I_ERRLOG with no 
accompanying data. For the trace logger, the ioctl has an ic_cmd field 
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of l_TRCLOG, and must be accompanied by a data buffer containing 
an array of one or more struct trace_ids elements. Each tracejds 
structure specifies an mid, sid, and level from which message will be 
accepted, strlog will accept messages whose mid and sid exactly 
match those in the tracejds structure, and whose level is less than or 
equal to the level given in the tracejds structure. A value of -1 in any 
of the fields of the tracejds structure indicates that any value is 
accepted for that field. 

At most one trace logger and one error logger can be active at a time. 
Once the logger process has identified itself via the ioctl call, log will 
begin sending up messages subject to the restrictions noted above. 
These messages are obtained via the getmsg(S) system call. The con- 
trol part of this message contains a log_ctl structure, which specifies 
the mid, sid, level, flags, time in ticks since boot that the message was 
submitted, the corresponding time in seconds since Jan. 1, 1970, and a 
sequence number. The time in seconds since 1970 is provided so that 
the date and time of the message can be easily computed, and the time 
in ticks since boot is provided so that the relative timing of log mes- 
sages can be determined. 

Different sequence numbers are maintained for the error and trace log- 
ging streams, and are provided so that gaps in the sequence of mes- 
sages can be determine (during times of high message traffic, some 
messages may not be delivered by the logger to avoid hogging system 
resources). The data part of the message contains the unexpanded text 
of the format string (null terminated), followed by NLOGARGS words 
for the arguments to the format string, aligned on the first word bound- 
ary following the format string. 

A process may also send a message of the same structure to log, even 
if it is not an error or trace logger. The only fields of the log_ctl struc- 
ture in the control part of the message that are accepted are the level 
and flags fields; all other fields are filled in by log before being for- 
warded to the appropriate logger. The data portion must contain a null 
terminated format string, and any arguments (up to NLOGARGS) must 
be packed one word each, on the next word boundary following the 
end of the format string. 

Attempting to issue an I_TRCLOG or I„ERRLOG when a logging pro- 
cess of the given type already exists will result in the error ENXIO 
being returned. Similarly, ENXIO is returned for LTRCLOG ioctls 
without any tracejds structures, or for any unrecognized I_STR ioctl 
calls. Incorrectly formatted log messages sent to the driver by a user 
process are silently ignored (no error results). 
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Example of I_ERRLOG notification: 

struct strioctl ioc; 
ioc.ic_cmd = l_EPRLOG; 

ioc . ic_tiiTK)ut = 0 ; /* default timeout (15 secs.) */ 

ioc.ic_len = 0; 
ioc.ic_dp = NULL; 

ioctl (log, I_STR, &ioc) ; 

Example of I_TRCLOG notification: 

struct trace_ids tid[2]; 

tid[0] .ti_mid = 2; 
tid[0J .ti_sid = 0; 
tid[0] ,ti_level =1; 

tid[l] .ti_mid = 1002; 

tid[l] .ti_sid = -1; /* any sub- id will be allowed */ 

tid[l] .ti_level = -1; /* any level will be allowed */ 

ioc.ic_cmd = IJTRCLOG; 
ioc . ic_timout =0; 

ioc.ic_len = 2 ^ sizeof (struct trace_ids) ; 
ioc . ic_dp = ( char * ) t id; 

ioctl (log, l_STR, &ioc) ; 

Example of submitting a log message (no arguments): 

struct strbuf ctl, dat; 
struct log_ctl Ic; 

char "^message = "Don't forget to pick up some milk on the way home" 

ctl.len = ctl.maxlen = sizeof (Ic); 
ctl.buf = (char *)&lc; 

dat.len = dat.maxlen = strlen (message) ; 
dat.buf = message; 

Ic. level = 0; 

Ic. flags = SL_ERR0R1SL_N0TIFY; 
putmsgdog, &ctl, &dat, 0); 

Files 



/dev/log <sys/log.h> <sys/strlog.h> 
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strace(ADM), strerr(ADM), clone(M), intro(S), getmsg(S), putmsg(S) 
STREAMS Programme fs Guide 
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login 

gives access to the system 
Syntax 

login [ name [ env-var . . . ] ] 

Description 



The login command is used at the beginning of each terminal session 
to identify the user and allow them access to the system. It cannot be 
invoked except when a connection is first established, or after the pre- 
vious user has logged out by sending an end-of-file ( Ctrl-D ) to their 
initial shell. 

login asks for your user name (if not supplied as an argument), and, if 
appropriate, your password and a dialup password. Echoing is turned 
off (where possible) during the typing of the passwords, so it will not 
appear on the written record of the session. 

If you make a mistake in the login procedure you will receive the mes- 
sage 



Login incorrect 



and a new login prompt will appear. The number of login attempts 
you are allowed, is configurable. If you make too many unsuccessful 
login attempts, you or the terminal can be locked out. 

If the login sequence is not completed successfully within a configur- 
able period of time (e.g., one minute), the user is returned to the “log- 
in:” prompt or silently disconnected from a dial-in line. 

After a successful login, accounting files (letcfutmp and letc/wtmp) are 
updated, the user is notified if they have mail, and the start-up shell 
files (i.e., .profile for the Bourne shell or .login for the C-shell) if any, 
are executed. 

login checks /etc/default/login for the following definitions of the the 
form DEFlNE=value: 

ALTSHELL 

If ALTSHELL is set to YES or if it is not present in 
/etc/default/login, then the SHELL environment variable is set to 
whatever shell is specified in the user’s /etc/passwd entry. If ALT- 
SHELL is set to NO, then the SHELL environment variable is set 
only if the shell is defined in the /usr/lib/mkuser directory (which 
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is list of recognized shells). 

CONSOLE 

The CONSOLE=(i^v/ce entry means that root can only log in on 
the device listed. For example, CONSOLE=/dev/console restricts 
root logins to the console device. 

IDLEWEEKS 

If a password has expired, the user is prompted to choose a new 
one. If it has expired beyond IDLEWEEKS, the user is not 
allowed to log in, and must consult system administrator. Works in 
conjunction with passwd(C), See cautions under Notes. 

OVERRIDE 

This allows root to log in on the console even if the protected pass- 
word database entry for root is corrupted, login checks 
/etc/default/login to see if there is an entry similar to the follow- 
ing, which identifies the tty to be used when doing an override log- 
in for root: 

OVERRIDE=tty01 

PASSREQ 

If PASSREQ=YES, this forces the user to select a password if they 
do not have one. PASSREQ=NO allows users to have accounts 
without passwords. See cautions under Notes. 

SUPATH 

If a user’s UID is 0 (i.e. if this is the superuser), the PATH variable 
is set to SUPATH, if SUPATH is specified in /etc/default/login. It 
is not advisable for SUPATH to include the current directory sym- 
bol (.). Note that an empty directory or at the begin- 

ning or end) is equivalent to 

ULIMIT 

This variable defnes the maximum allowable file size. The default 
is 2,097,152 blocks, or 1 gigabyte. When setting ULIMIT, be sure 
to specify even numbers, as the ULIMIT variable accepts a number 
of 512-byte blocks. 

UMASK 

This is the default file creation mask (see umask(C)). 

login initializes the user and group IDs and the working directory, 
then executes a command interpreter (usually sh(C)) according to spe- 
cifications found in the /etc/passwd file. Argument 0 of the command 
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interpreter is a dash (-) followed by the last component of the 
interpreter’s pathname. The basic environment (see environ (}A)) is 
initialized to: 

HOME= your-login-directory 
SHELL=last field of passwd entry 
MATL=/usT/spool/mai\/your-login-name 



Initially, umask is set to octal 022 by login. 

Files 



/etc/utmp 


Information on current logins 


/etc/wtmp 


History of logins since last multiuser 


/usr/spool/mail/nam^ 


Mailbox for user name 


/etc/motd 


Message of the day 


/etc/defaultAogin 


Default values for environment 
variables 


/etc/passwd 


Password file 


/etc/profile 


System profile 


$HOME/.profile 


Personal profile 


See Also 




environ(M), getty(ADM), initscript(F), machine(HW), mail(C), 
newgrp(C), passwd(C), passwd(F), profile(M), su(C), sh(C), ulimit(S), 
umask(C), who(C) 


Diagnostics 





Not on system console 

login is set up to allow root to log on on the console only, 
and you are not on the system console. 



Login incorrect 

The login or dialup password is incorrect. 



Unable to change directory to dir 

login cannot change directories to the home directory as 
specified by ! etc! passwd. 



No utmp entry. You must exec 'login' from the lowest level 'sh'. 
init did not put an entry in utmp. 
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No Root Directory 

The shell field starts with a and the attempt to do a 
chroot to the home directory failed. 

You don't have a password. 

A password is required and it hasn’t been set previously. 

Protected Password information suddenly vanished 

During the course of working with the protected password 
database information the pointer pointing to the static ver- 
sion of the information has suddenly disappeared. 

Cannot execute passwd program 

The password program cannot be executed for some rea- 
son. 

Login aborted due to no password. 

The password program has returned an error while setting a 
password, as when the <DEL> key is pressed. 

Cant rewrite protected password entry for user name, 
Authentication error; see Account Administrator 

The login program cannot update the protected password 
database entry. 

Protected Password database problem 

After updating Protected Password data, login reads the in- 
formation again and the entry cannot be read. 

Account is disabled but console login is allowed. 

Account is disabled - see Account Administrator. 

If the account is locked, but root is logging in on the con- 
sole (OVERRIDE tty), the first message is displayed; an 
ordinary user will see the second. 

Account has been retired - logins are no longer allowed. 

The account is retired (no override for this condition). 

Cannot set terminal mode. 

The chmod of the tty failed. 

Bad login user id. 

No uid has been set. This can be due to a missing critical 
database file, such as ! etc! authlsystemi authorize. Rrn 
authck{NDM) and check any error messages. This mes- 
sage will also be issued if login is run from an established 
login session rather that from mi7(M). 

Wait for login retry. 

Wait for login exit. 

A login attempt has failed, and the system is configured to 
enforce a delay between login attempts. 
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user appears in letcipasswd but not in Protected Password database 
If the user is in letcipasswd but not in the Protected Pass- 
word database, there is no message printed, but login gen- 
erates the following audit record. 

Cannot obtain database information on this terminal 

login cannot get information from the ! etc! authlsy stem! ttys 
file for the tty line. 

Error in terminal setup. 

Something is wrong with the terminal setup (for example, 
stdin in, stdout, and stderr are the same thing). 

Cannot obtain settings for this terminal 
The ioctl(S) on the tty device failed. 

No login program on root 

When attempting to do a sublogin (chrooting to a subtree 
for a restricted login), no login program was found. 

Cant rewrite terminal control entry for tty, 

Authentication error; see Account Administrator 

The information for the login tty cannot be updated. 

Terminal Control information suddenly vanished 

During the course of working with the terminal database 
information the pointer pointing to the static version of the 
information suddenly disappeared. 

Bad priority setting. 

nice failed to set the nice value specified in the Protected 
Password entry for the user. 

Bad group id. 

The call to setgid failed. 

Bad user id. 

The call to setuid failed. 

Unable to set kernel authorizations. 

The call to set the kernel authorizations failed. 

Login timed out 

login received an ALARM signal. Note: login sets this 
itself, but it could conceivably come from somewhere else. 

Terminal is disabled but root login is allowed. 

Terminal is disabled - see Account Administrator. 

If the terminal is disabled, but you are root login in on the 
console (OVERRIDE tty) the first message is displayed; 
the second is displayed for ordinary users. 
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The security databases are corrupt. 

However, root login at terminal tty is allowed, 

This is the message displayed when the OVERRIDE tty is 
used during a security problem. 



Impossible to execute Ibinish! 

login cannot execute the shell program for doing an 



OVERRIDE. 



Notes 



login cannot be executed from a shell. 

Environment variables such as HZ, PATH, and so forth should not be 
defined in /etc/default/login. Instead use letdinitscript to set global 
variables. 

Sublogins (indicated by a shell of “*”) are not supported and cause a 
warning. 

Although IDLEWEEKS and PASSREQ are supported for compatibil- 
ity with other UNIX systems, their use is not recommended. The 
proper way to set the behavior defined by these variables is by use of 
the sysadmsh(ADM) Accounts selection. 
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mapchan 

configure tty device mapping 

Syntax 



mapchan [-ans] [ -f mapfile ] [ channels ... ] 
mapchan [ [ -o ] [ -d ] ] [ channel ] 

Description 



mapchan configures the mapping of information input and output. 
The mapchan utility is intended for users of applications that employ 
languages other than English (character sets other than 7-bit ASCII). 

mapchan translates codes sent by peripheral devices, such as termi- 
nals, to the internal character set used by the Altos UNIX System V 
system, mapchan can also map codes in the internal character set to 
other codes, for output to peripheral devices (such as terminals, 
printers, console screen, etc.). Note that PC keyboard configuration is 
accomplished through the mapkey (M) utility. 

mapchan has several uses: to map a channel (-a or -s); to unmap a 
channel (-n and optionally -a); or to display the map on a channel 
(optionally -o, -d, channels). 

mapchan with no options displays the map on the user’s channel. The 
map displayed is suitable as input for mapchan. 

The options are: 

-a when used alone, sets all channels given in the default file 
(/etc/default/mapchan) with the specified map. When used 
with -n, it refers to all channels given in the default file. Super- 
user maps or unmaps all channels, other users map only chan- 
nels they own. -a can not be used with -d, -o, or -s. 

-d causes the mapping table currently in use on the given device, 
channel , to be displayed in decimal instead of the default hexa- 
decimal, An ASCII version is displayed on standard output. This 
output is suitable as an input file to mapchan for another chan- 
nel. Mapped values are displayed. Identical pairs are not out- 
put. -d can not be used with -a, -f, -n, -o, or -s. 

-f causes the current channel or list of channels to be mapped with 
mapfile . -f can not be used with -d, -n, -s, or -o. 
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-n causes null mapping to be performed. All codes are input and 
output as received. Mapping is turned off for the user’s channel 
or for other channels, if given, -a used with -n will turn map- 
ping off on all channels given in the default file. This is the 
default mapping for all channels unless otherwise configured. - 
n can not be used with -d, -f, -o, or -s. 

-o causes the mapping table currently in use on the given device, 
channel, to be displayed in octal instead of the default hexadec- 
imal. An ASCII version is displayed on standard output. This 
output is suitable as an input file to mapchan for another port. 
Mapped values are displayed. Identical pairs are not output. >o 
can not be used with -a, -d, -f, -n, or -s. 

-s sets the user’s current channel with the mapfile given in the 
default file, -s can not be used with any other option. 

The user must own the channel in order to map it. The super-user can 
map any channel. Read or write permission is required to display the 
map on a channel. 

Each tty device channel (display adapter and video monitor on com- 
puter, parallel port, serial port, etc.) can have a different map. When 
Altos UNIX System V boots, mapping is off for all channels . 

mapchan is usually invoked in the /etc/rc2 scripts. These scripts are 
executed when the system enters multi-user mode and sets up the 
default mapping for the system. Users can invoke mapchan when they 
log in by including a mapchan command line in their .profile or .login 
file. In addition, users can remap their channel at any time by invok- 
ing mapchan from the command line, channels not listed in the 
default file are not automatically mapped, channels are not changed 
on logout. Whatever mapping was in place for the last user remains in 
effect for the next user, unless they modify their .profile or .login file. 

For example, the default file /etc/default/mapchan can contain: 

tty02 ibm 

tty la 

tty2a wybO.ger 

Ip ibm 

The default directory containing mapfiles is /usr/lib/mapchan. The 
default directory containing channel files is /dev. Full pathnames m?y 
be used for channels or mapfiles. If a channel has no entry, or the 
entry field is blank, no mapping is enabled on that channel. Addi- 
tional channels added to the system, (for example, adding a serial or 
parallel port) are not automatically entered in the mapchan default 
file. If mapping is required, the system administrator must make the 
entries. 
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The format of the mapfiles is documented in the mapchan(F) manual 
page. 



Using a Mapped channel 

The input information is assumed to be 7- or 8-bit codes sent by the 
peripheral device. The device may make use of “dead” or “com- 
pose” keys to produce the codes. If the device does not have dead or 
compose keys, these keys can be simulated using mapchan. 

One to one mapped characters are displayed when the key is pressed, 
and the mapped value is passed to the kernel. 

Certain keys are designated as dead keys in the mapfile. Dead key 
sequences are two keystrokes that produce a single mapped value that 
is passed to the kernel. The dead key is usually a diacritical character, 
the second key is usually the letter being modified. For example, the 
sequence ' e could be mapped to the ASCII value 0xE9, and display as 
e. 

One key is designated as the compose key in the mapfile. Compose 
key sequences are composed of three keystrokes that produce a single 
mapped value that is passed to the kernel. The compose key is usually 
a seldom used character or cXil-letter combination. The second key is 
usually the letter being modified. The third key may be another char- 
acter being combined, or a diacritical character. For example, if ’ is 
the compose key, the sequence @ c O could be mapped to the ASCII 
value 0xA9, and display as ©. 

Characters are not echoed to the screen during a dead or compose 
sequence. The mapped character is echoed and passed to the kernel 
once the sequence is correctly completed. 

Characters are always put through the input map, even when part of 
dead or compose sequences. The character is then checked for the 
internal value. The value may also be mapped on output. This should 
be kept in mind when preparing map files. 

The following conditions will cause an error during input: 



• non-recognized (not defined in the mapfile) dead or compose 
sequence 

• restarting a compose sequence before completion by pressing 
the compose key in the middle of a dead or compose sequence. 
This is an error, but a new compose sequence is initiated. 

If the mapfile contains the keyword beep , a bell sounds when either of 
the above conditions occurs. In either case, the characters are not 
echoed to the screen, or passed to the kernel. 
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In order to allow for character sequences sent to control the terminal 
(move the cursor, and so on) rather than to print characters on the 
screen, mapchan allows character sequences to be specified as special 
sequences which are not passed through the normal mapping pro- 
cedure. Two sections may be specified, one for each of the input (key- 
board) and output (screen) controls. 



Character Sets 

The internal character set used is defined by the map files used. By 
default, this is the ISO 8859/1 character set which is also known as the 
dpANS X3.4.2 and ISO/TC97/SC2. It supports most of the Latin 
alphabet and can represent most European languages. 

Several partial map files are provided as examples. They must be 
modified for use with specific peripheral devices. Consult your hard- 
ware manual for the codes needed to display the desired characters. 
Two map files are provided for use with the console device: 
/usr/lib/mapchan/ibm for systems with a standard PC character set 
ROM, and /usr/lib/mapchan/iso for systems with an optional ISO 
8859/1 character set ROM. 

Care should be taken that the sttyiC) settings are correct for 8-bit ter- 
minals. The /etc/gettydefs file may require modification to allow log- 
ging in with the correct settings. 

7-bit U.S. ASCII (ANSI X3.4) should be used if no mapping is enabled 
on the channel . 



Files 



/etc/default/mapchan 

/usrAib/mapchan/* 




See Also 




ascii(M), keyboard(HW), 
mapkey(M), parallel(HW), 
trchan(M), tty(M) 


lp(C), Ipadmin(ADM), mapchan(F), 
screen(HW), serial(HW), setkey(M), 


Notes 





Some non-U.S. keyboards and display devices do not support charac- 
ters commonly used by Altos UNIX System V command shells and the 
C programming language. It is not recommended that these devices be 
used for system administration tasks. 
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Printers can be mapped, output only, and can either be sent 8-bit codes 
or one-to-many character strings using mapchan. Line printer spooler 
interface scripts can be used (setuid root) to change the output map on 
the printer when different maps are required (as in changing print 
wheels to display a different character set). See lp(C) and 
Ipadmin (ADM) for information on installing and administering inter- 
face scripts. 

Not all terminals or printers can display all the characters that can be 
represented using this utility. Refer to the device’s hardware manual 
for information on the capabilities of the peripheral device. 

Warnings 



Use of mapfiles that specify a different “internal” character set per- 
channel, or a set other than the 8-bit ISO 8859 set supplied by default 
can cause strange side effects. It is especially important to retain the 
7-bit ASCII portion of the character set (see ascii (M)). Altos UNIX 
System V utilities and many applications assume these values. 

Media transported between machines with different internal code set 
mappings may not be portable as no mapping is performed on block 
devices, such as tape and floppy drives. However, trchan with an ap- 
propriate mapfile can be used to “translate” from one internal charac- 
ter set to another. 

Do not set ISTRIP (see stty(C)) when using mapchan. This option 
causes the eighth bit to be stripped before mapping occurs. 

Value Added 



mapchan is an extension of AT&T System V provided in Altos UNIX 
System V. 
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mapkey, mapscrn, mapstr, convkey 

configure monitor screen mapping 
Syntax 



mapkey [ -dox ][ datafile ] 
mapscrn [ -d ][ datafile ] 
mapstr [ -d ][ datafile ] 
convkey [ in [ out ] ] 

Description 



mapscrn configures the output mapping of the monitor screen on 
which it is invoked, mapkey and mapstr configure the mapping of the 
keyboard and string keys (eg. function keys) of the monitor (and mul- 
tiscreens if present), mapkey can only be run by the super-user. 

mapstr functions on a per-screen basis. Mapping strings on one screen 
does not affect any other screen. 

If a file name is given on the argument line the respective mapping 
table is configured from the contents of the input file. If no file is 
given, the default files in /usr/lib/keyboard and /usr/lib/console is 
used. The -d option causes the mapping table to be read from the ker- 
nel instead of written and an ASCII version to be displayed on the 
standard output. The format of the output is suitable for input files to 
mapscrn, mapkey, or mapstr . Non-super-users can run mapkey and 
mapstr when the -d option is given. 

With the -o or -x options, mapkey displays the mapping table in octal 
or hexadecimal. 

convkey translates an old-style mapkey file into the current format. If 
in or out are missing, they default to stdin or stdout. 

Files 



/usr/lib/keyboard/* 

/usrAib/console/* 
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Notes 



There is no way to specify that the map utilities read their configura- 
tion tables from standard input. 

See Also 



keyboard(HW), screen(HW), setkey(C) 

Value Added 



convkey, mapkey, mapscrn and mapstr are extensions of AT&T Sys- 
tem V provided in Altos UNIX System V. 
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math 

math functions and constants 

Syntax 

#indude <math.h> 

Description 



This file contains declarations of all the functions in the Development 
System Math Library as well as various functions in the C Library that 
return floating-point values. 

It defines the structure and constants used by the matherr(S) error- 
handling mechanisms, including the following constant used as an 
error-return value: 

HUGE The maximum value of a single-precision 

floating-point number. 

The following mathematical constants are defined for user conveni- 
ence: 

M_E 

M_LOG2E 
M_LOG10E 
M_LN2 
M_LN10 
M_PI 

M_PI_2 
M_PI_4 
M_1_PI 
M_2_PI 
M_2_SQRTPI 
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The base of natural logarithms (e). 

The base-2 logarithm of e . 

The base- 10 logarithm of e. 

The natural logarithm of 2. 

The natural logarithm of 10. 

7t, the ratio of the circumference of a circle to 
its diameter. 

nl2. 

7C/4. 

1/k, 

2/tc. 

2/Vtc. 
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M_SQRT2 The positive square root of 2. 

M_SQRT1_2 The positive square root of 1/2. 

For the definitions of various machine-dependent “constants,” see the 
description of the <values.h> header file. 

See Also 



intro(S), matherr(S), values(M) 

Standards Conformance 



math is conformant with: 

The X/Open Portability Guide II of January 1987. 
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mconvert 

compile menu into AOM 
Syntax 



mconvert input_file output_file 

Description 



The mconvert command is used for compiling a menu into an AOM 
menu file. The input_file is the path and file name of a form file, and 
the output_file is the path and file name of the compiled AOM menu 
file which can be 

For more details see the Altos manual AOM Tool Kit User's Guide, 
part number 690-17464-jmc. 

Fiies 



/usr/aom/AOMcap 

/usr/aom/aomtext 

/usr/aom/aom.msgs 

/usr/aom/defupdate 

/usr/aom/form.format 

/usr/aom/form.recover 

/usr/aom/aomnames 

/usr/aom/aomplanes 

/usr/aom/creatext 

/usr/aom/form.archive 

/usr/aom/form.fsck 

/usr/aom/setmsg 

See Also 



aom(M), fconvert(M) 
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messages 

description of system console messages 

Description 



This section describes the various system messages which may appear 
on the system console. All messages are displayed in the following 
format: 

label:severity:comment:action 
The segments break down as follows: 
label 

Name of the driver or routine where the error occurred. 



severity 

The level of error severity, consisting of four levels: 

PANIC These fatal messages indicate hardware problems 
or kernel inconsistencies that are too severe for 
continued operation. After displaying a PANIC 
message, the system stops. Rebooting is required. 

ERROR Resource use has been affected. Some corrective 
action is needed. 

WARNING An error indication that should be monitored 
(example, free file space is low) but requires no 
immediate action. 



INFO Some information about the system is provided. 

comment 

A field containing information about the problem at hand. 



action 

The course of action to remedy the situation. 

The system services error messages are generated by the shell and do 
not follow the above convention. 



System Message Meanings 

The following classifications are meant to be a key for you to use to 
determine the actions to take to correct an error situation. Each kernel 
message will have one of the following three classifications listed 
with it. The classifications are: 
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System inconsistency 

A contradictory situation exists in the kernel. 

Abnormal 

A probably legitimate but extreme situation exists. 

Hardware 

Indicates a hardware problem. 

System inconsistency messages indicate problems usually traceable to 
hardware malfunction, such as memory failure. These messages 
rarely occur since associated hardware problems are generally 
detected before such an inconsistency can occur. 

Abnormal messages represent kernel operation problems, such as the 
overflow of critical tables. It takes extreme situations to bring these 
problems about, so they should never occur in normal system use. 
However, in some cases you can modify the kernel parameters that are 
causing the error message. Use the conjigure{A\yWl) utility to make 
the necessary changes. 

Hardware messages normally specify the device, deVy that caused the 
error. Each message gives a device specification of the form nnlmm 
where nn is the major number of the device, and mm is its minor num- 
ber. The command pipeline 

Is -1 /dev I grep nn \ grep mm 

may be used to list the name of the device associated with the given 
major and minor numbers. 

System Messages 



** Normal System Shutdown ** 

This message appears when the system has been shutdown prop- 
erly. It indicates that the machine may now be rebooted or 
powered down. 

kemeliPANIC:** ABNORMAL System Shutdown ** 

This message appears when errors occur during system shut- 
down. It is usually accompanied by other system messages. 
System inconsistency ^ fatal. 

kemel:WARNING:bad block on dev nnlmm 

A nonexistent disk block was found on, or is being inserted in, 
the structure’s free list. System inconsistency. 

kernel: WARNINGibad count on dev nnlmm 

A structural inconsistency in the superblock of a file system. 
The system attempts a repair, but this message will probably be 
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followed by more complaints about this file system. System 
inconsistency. 

kernel: WARNING :Bad free count on dev nnimm 

A structural inconsistency in the superblock of a file system. 
The system attempts a repair, but this message will probably be 
followed by more complaints about this file system. System 
inconsistency. 

kernel :ERROR terror on dev name {nnimm) 

This is the way that most device driver diagnostic messages 
start. The message will indicate the specific driver and com- 
plaint. The name is a word identifying the device. 

kemel:ERROR:iaddress > 2"24 

This indicates an attempted reference to an illegal block num- 
ber, one so large that it could only occur on a file system larger 
than 8 billion bytes. Abnormal. 

kemel:WARNING:Inode table overflow 

Each open file requires an inode entry to be kept in memory. 
When this table overflows, the specific request (usually open{S) 
or creat{S)) is refused. Although not fatal to the system, this 
event may damage the operation of various spoolers, daemons, 
the mailer, and other important utilities. Abnormal results and 
missing data files are a common result. Use configure{AT>M) to 
raise the number of inodes. Abnormal. 

kemel:WARNING:interrupt from unknown device, vec=nw/n 

The CPU received an interrupt via a supposedly unused vector. 
This message is followed by “panic lunknown interrupt.” Typi- 
cally, this event comes about when a hardware failure miscom- 
putes the vector of a valid interrupt. Hardware. 

kemel:WARNING:stray interrupt on vector num 

The CPU received an interrupt via a supposedly unused vector. 
Hardware. 

kemel:WARNING:no file 

There are too many open files. The system has run out of entries 
in its “open file” table. The warnings given for the message 
“inode table overflow” apply here. Use conjigure{AT>M) to 
raise the total number of available files or the numter of files 
available per process. Abnormal. 

kemel:WARNING:no space on dev nnimm 

This message means that the specified file system has run out of 
free blocks. Although not normally as serious, the warnings dis- 
cussed for “inode table overflow” applyioften user programs 
are written casually and ignore the error code returned when 
they tried to write to the disk; this results in missing data and 
“holes” in data files. The system administrator should keep 
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close watch on the amount of free disk space and take steps to 
avoid this situation. Abnormal. 

kemel:WARNING:Out of inodes on dev nnimm 

The indicated file system has run out of free inodes. The number 
of inodes available on a file system is determined when the file 
system is created (using ml^s (ADM)). The default number is 
quite generous; this message should be very rare. The only 
recourse is to remove some worthless files from that file system, 
or dump the entire system to a backup device, run mlrfs (ADM) 
with more inodes specified, and restore the files from backup. 
Abnormal 

kernel:? ANIC:blkdev 

An internal disk I/O request, already verified as valid, is discov- 
ered to be referring to a nonexistent disk. System inconsistency, 
fatal 

kernel :P ANIC idevtab 

An internal disk I/O request, already verified as valid, is discov- 
ered to be refering to a nonexistent disk. System inconsistency, 
fatal 

kernel:? ANIC:iinit 

The super-block of the root file system could not be read. This 
message occurs only at boot time. Hardware, fatal 

kernel:? ANIC:swap 10 error 

A fatal I/O error occurred while reading or writing the swap 
area. System inconsistency, fatal 

kernel:? ANIC:memory failure - parity error 

A hardware memory failure trap has been taken. System incon- 
sistency, fatal 

kernel:? ANIC:no fs 

A mounted file system’s entry has disappeared from the system 
mount table. System inconsistency, fatal 

kernel:? ANIC:no imt 

A mounted file system has disappeared from the mount table. 
System inconsistency, fatal 

kernel:? ANIC:no procs 

Each user is limited in the amount of simultaneous processes he 
can have; an attempt to create a new process when none is 
available or when the user’s limit is exceeded and refused. That 
is an occasional event and produces no console messages; this 
panic occurs when the kernel has certified that a free process 
table entry is available and can’t find one when it goes to get it. 
System inconsistency , fatal 
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kernel :WARNING:Out of swap 

There is insufficient space on the swap disk to hold a task. The 
system refuses to create tasks when it feels there is insufficient 
disk space, but it is possible to create situations to circumvent 
this mechanism. Abnormal 

kemel:PANIC:general protection trap 

General protection trap taken in kernel. System inconsistency, 
fatal 

kernel: PANIC: segment not present 

An attempt has been made to access an invalid segment. It may 
also indicate the segment-not-present trap has been taken in the 
kernel. System inconsistency, fatal 

kernel :PANIC:Timeout table overflow 

The timeout table is full. Timeout requests are generated by de- 
vice drivers, there should usually be room for one entry per sys- 
tem serial line plus ten more for other usages. Use conjig- 
ure(ADM) to raise the number of timeout table entries. 

kernel :PANIC:Trap in system 

The CPU has generated an illegal instruction trap while execut- 
ing kernel or device driver code. This message is preceded with 
an information dump describing the trap. System inconsistency, 
fatal 

kemel:PANIC:Invalid TSS 

Internal tables have become corrupted. System inconsistency, 
fatal 

kemel:WARNING:bootstring invalid, ignored 

A bad bootstring was entered at the Boot prompt. 

kemel:ERROR:bad syntax - string 

A bad bootstring was enter^ at the Boot prompt. 

kemel:PANIC:bad mapping in copyio 

Copyio was called with a strange request. Usually a bad driver. 

kemel:WARNING:HARDWARE FAILURE:386 incorrectly multi- 
plies 32-bit numbers 

The cpu is displaying the 32-bit multiply bug. 

kemekPANIC:*** POWER CYCLE TO REBOOT *** 

This message follows the above HARDWARE FAILURE 32 bit 
error message. 

kemel:INFO:10 bits of I/O address decoding 

The hardware is only decoding 10 bits of i/o addresses. This 
amount is sufficient in most cases. This condition is only an 
issue if you are strapping i/o devices with a base address above 
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400 (hex). 

kemel:WARNING:A31 CPU bug workaround not possible for this 
machine 

A31 was specified on the boot line, but cannot be applied to the 
current system. 

kemel:INFO:A31 CPU bug workaround in effect 

A31 was specified on the boot line and the software workaround 
is currently in effect. 

kemel:PANIC:bad boot string An invalid boot string was entered at 
the Boot prompt. 

kemel:PANIC:out of both memory & swap 

No more memory pages or swap pages are free. 

kemel:PANIC:not enough contiguous memory 

The kernel memory allocation routines require more physically 
contiguous memory. Either decrease the size of some kernel 
parameters (like disk buffers) or add more physical memory. 

kemel:WARNING:filesystem page read failed 

An error occurred trying to read a page from the disk. This is 
not fatal, but usually indicates hardware problems. 

kemel:PANIC:free inode isn’t 

There is internal inode table corruption within the kernel. 

kemel:ERROR:Map overflow (nww), shutdown and reboot, mp- 
>mpent 

There are internal kernel map inconsistencies. Reboot your sys- 
tem. 

kemel:PANIC:write_sb();cannot cvts3superb() yet 

This message is found in the 386 kernel only. A write of a non 
SYS III or SYS V filesystem superblock is being attempted. 
This action should be impossible due to earlier checks. 

kemel:WARNING:Can’t allocate message buffer 

This message indicates a lack of memory. Processes should be 
killed to m^e more room. Another option is to add more physi- 
cal memory. 

kemel:PANIC:Large model 386 ssig 

Internal kernel error in processing large model 386 signals. 
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Trsip type 

This message precedes a “kernel:? ANIC:” message. The type 
is the trap number given by the processor. The message is fol- 
lowed by a dump of registers. System inconsistency, fatal. 

fpsave:PANIC:no fp_task 

No floating point context to save, internal kernel error. 

mdep.386/fp.c:WARNING:No floating point emulator found in string, 
No ! etc! emulator was present in the root filesystem. The System 
Administrator should install one and reboot. 

fp_OVERRUN:PANIC:coprocessor overrun - with no 287/387 
Internal coprocessor error, fatal. 

fp_COPROC:PANIC:, coprocessor error - with no 287/387 
Inconsistent kernel internal state. 

fp_COPROC:PANIC:coprocessor error - switched away from fp_task 
Internal kernel mismanagement of floating point processes. 

fp^DNA:PANIC: 

A device trap happened while emulating floating point instruc- 
tions. 

iinit:PANIC:cannot copy in superblock 

An error happened during the root filesystem superblock load- 
ing. 

srmount:PANIC:cannot cvtv7superb() yet 

A root filesystem superblock was not recognized as a SYS III or 
SYS V superblock. V7 superblocks cannot currently be con- 
verted on the 386 kernel. 

mapphys:PANIC:sptmap overflow 

No system page table pages are available. This is an internal 
error in the kernel, usually caused by a faulty device driver. 

physio -.PANIC :bad state A device driver made an invalid request to 
physio. 

badint:PANIC:bad interrupt handler Invalid interrupt request, usually 
fault hardware. 

setup:PANIC:sptmap overflow This message indicates possible kernel 
image corruption or lack of physical memory. 

setup:? ANIC:u-area not page aligned This indicates possible kernel 
image corruption. 
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setup:? ANIC:u-area address does not match SPTADDR 
Indicates possible kernel image corruption. 

cmn_err:PANIC:DOUBLE PANIC The kernel panicked while trying 
to panic. You must power cycle at this point to reboot the ma- 
chine. 

cmn_err:PANIC:unknown level in cmn__err (level=nwm, msg=string). 
The kernel’s cmn_err() routine was called with an invalid argu- 
ment. 



Kernel Paging Messages 

The following messages indicate system inconsistencies in the kernel 
paging code. These inconsistencies can be caused by hardware or soft- 
ware problems. Reboot your system and note the circumstances if you 
see one of these messages: 

mfalloc:PANIC:page not free 

mfalloc:PANIC:page not free at exit 

mfifree:PANIC:page already free 

mfifree:PANIC:page is locked 

dfalloc:P ANIC:frame not free at exit 

xlcheck:PANIC:xlink serial mismatch 

impcode:PANIC:called to load impure 386 

impcode:PANIC:more than 1 data segment? 

preload:PANIC:, invalid page (mm, mm) 

kernel:? ANIC:bad page type for protection fault 

kernel:? ANIC:protection fault on read access 

kernel:? ANIC:not present fault on shared data 

kernel:? ANIC:added strange page table - mm, index 

pgfind:?ANIC:not in cache 

pghash:?ANIC:not in cache 

pginval:?ANIC:list broken 
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pginval:PANIC:not in cache 

mftomp:PANIC:bad frameno num 

mptomf:PANIC:bad mp num 

swapadd:PANIC:no space fordpfi 

dftodp:PANIC:bad frameno num 

dptodf:PANIC:bad dp num 

dptodf:PANIC:bad dp num 

pgread:PANIC:no xlink 

pgfree:PANIC:invalid page marked present 

pgfree:PANIC:freeing intransit page 

pgpid:WARNING:setting disk pid 

kemel:PANIC:page table under page table? 

kemel:PANIG:swapping intransit page 

dftomf:PANIC:non-swap page table entry changed 

dftomf:PANIC:swap disk frame rcnt(nwm) != 1, dp=nMm, dp- 
>dp_rcnt,dp 

dftomf:PANIC:page type mismatch - mptype num dptype num mp num 
dp num, mp->mp_type, dp->dp_type, mp, dp 

dftomf2:PANIC:, swap memory frame xcni(num) != 1, mp=/iMm, 

dftomf3:PANIC:swap mem frame rcnt(nwm) != 1, mp=nMm, mp- 
>mp_rcnt, mp 

mftodf 1 :PANIC:swap mem frame rcnt(n«m) != 1, mp=nww, mp- 
>mp__rcnt, mp 

mftodf:PANIC:memory frame marked in transit 

mftodf:PANIC:page type mismatch - dptype num mptype num dp num 
mp num 

mftodf2:PANIC:swap disk frame rcnt(nwm) 1= 1, dp=nMm 

mftodf3:PANIC:swap disk frame rcnt(^zMm) != 1, dp=nww, dp- 
>dp_rcnt, dp 
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fftomf:PANIC:page type(nMm) not TE_FILSYS, mp = num,mp- 
>nip_type, mp 

mfcvt:PANIC:zero ref count 

ptdup:PANIC:TE_SWAP page Tcnt(num) >1, 

ptdup:PANIC:xlinked page has reference 

ptdup2:PANIC:TE_SWAP page rent > 1 

ptdup:PANIC:xlinked page has reference 

ptdup:PANIC:locked page not present 

ptdup:PANIC:intransit page 

pgcheck:PANIC:page type mismatchrptp num type num xtype 
nwm,ptp,type,xtype 

The above listed messages indicate system inconsistencies in the ker- 
nel paging code. These inconsistencies can be caused both by hard- 
ware or software problems. Reboot your system. 

cputok:PANIC: 

cpktou-.PANIC: 

sdfrcm:PANIC:sdp->sd_inode not found 

The above 3 errors indicate internal shared data errors within the ker- 
nel. 

v86sighdlint:WARNING:lost signal 
v86setint:PANIC:xtss pte not present 

The above 2 errors indicate internal VPIX processing errors within the 
kernel. 

namei:PANIC:null cache ino 
namei:PANIC:duplicating cache 

The above 2 messages indicate internal file management errors in the 
kernel. 

System Services Messages 



The following messages are displayed by the shell when a system call 
fails. 
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Not owner: 

Typically, this error indicates an attempt to modify a file in some 
way forbidden except to its owner or super-user. It is also returned 
for attempts by ordinary users to do things allowed only to the 
super-user. 

No such file or directory: 

This error occurs when a filename is specified and the file should 
exist but doesn’t, or when one of the directories in a pathname does 
not exist. 

No such process: 

No process can be found corresponding to that specified by pid in 
kill orptrace. 

Interrupted system call: 

An asynchronous signal (such as interrupt or quit), which the user 
has elected to catch, occurred during a system call. If execution is 
resumed after processing the signal, it will appear as if the inter- 
rupted system call returned this error condition. 

I/O error: 

Some physical I/O error. This error may in some cases occur on a 
call following the one to which it actually applies. 

No such device or address: 

I/O on a special file refers to a subdevice which does not exist, or 
beyond the limits of the device. It may also occur when, for exam- 
ple, a tape drive is not on-line or no disk pack is loaded on a drive. 

Arg list too long: 

An argument list longer than 5,120 bytes is presented to a member 
of the exec family. 

Exec format error: 

A request is made to execute a file which, although it has the ap- 
propriate permissions, does not start with a valid magic number 
(see a.out(F)). 

Bad file number: 

Either a file descriptor refers to no open file, or a read (respectively 
write) request is made to a file which is open only for writing 
(respectively reading). 

No child processes: 

A wait was executed by a process that had no existing or 
unwaited-for child processes. 

No more processes: 

A fork failed because the system’s process table is full or the user 
is not allowed to create any more processes. 
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Not enough space: 

During an exec y or sbrk, a program asks for more space than the 
system is able to supply. This is not a temporary condition; the 
maximum space size is a system parameter. The error may also 
occur if the arrangement of text, data, and stack segments requires 
too many segmentation registers, or if there is not enough swap 
space during di fork. 

Permission denied: 

An attempt was made to access a file in a way forbidden by the 
protection system. 

Bad address: 

The system encountered a hardware fault in attempting to use an 
argument of a system call. 

Block device required: 

A nonblock file was mentioned where a block device was required, 
e.g., in mount. 

Device busy: 

An attempt to mount a device that was already mounted or an 
attempt was made to dismount a device on which there is an active 
file (open file, current directory, mounted-on file, active text seg- 
ment). It will also occur if an attempt is made to enable account- 
ing when it is already enabled. 

File exists: 

An existing file was mentioned in an inappropriate context, e.g., 
link. 

Cross-device link: 

A link to a file on another device was attempted. 

No such device: 

An attempt was made to apply an inappropriate system call to a 
device; e.g., read a write-only device. 

Not a directory: 

A nondirectory was specified where a directory is required, for 
example, in a path prefix or as an argument to chdir(S). 

Is a directory: 

An attempt to write on a directory. 

Invalid argument: 

An invalid argument (e.g., dismounting a nonmounted device; 
mentioning an undefined signal in signal or kill ; reading or writing 
a file for which Iseek has generated a negative pointer). Also set 
by the math functions described in the (S) entries of this manual. 
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File table overflow: 

The system’s table of open files is full and temporarily no more 
opens can be accepted. 

Too many open files: 

No process may have more than 60 file descriptors open at a time. 
Not a character device 
Text file busy: 

An attempt to execute a pure-procedure program which is 
currently open for writing (or reading). Also an attempt to open 
for writing a pure-procedure program that is being executed. 

File too large: 

The size of a file exceeded the maximum file size (1,082,201,088 
bytes) or ULIMIT; see ulimit(S). 

No space left on device: 

During a write to an ordinary file, there is no free space left on the 
device. 

Illegal seek: 

An Iseek was issued to a pipe. 

Read-only file system: 

An attempt to modify a file or directory was made on a device 
mounted read-only. 

Too many links: 

An attempt to make more than the maximum number of links 
(1000) to a file. 

Broken pipe: 

A write on a pipe for which there is no process to read the data. 
This condition normally generates a signal; the error is returned if 
the signal is ignored. 

Arg out of domain of func: 

The argument of a function in the math package is out of the 
domain of the function. 

Result too large: 

The value of a function in the math package is not representable 
within machine precision. 

File system needs cleaning: 

An attempt was made to mount{S) a file system whose super-block 
is not flagged clean. 
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Would deadlock: 

A process’ attempt to lock a file region would cause a deadlock 
between processes vying for control of that region. 

Not a name file: 

A creatsem{S\ opensem(S\ waitsem(S), or sigsem{S) was issued 
using an invalid semaphore identifier. 

Not available: 

An opensem(S\ waitsem(S) or sigsem(S) was issued to a sema- 
phore that has not been initialized by a call to creatsem(S). A sig- 
sem was issued to a semaphore out of sequence; i.e., before the 
process has issued the corresponding waitsem to the semaphore. 
An nbwaitsem was issued to a semaphore guarding a resource that 
is currently in use by another process. The semaphore on which a 
process was waiting has been left in an inconsistent state when the 
process controlling the semaphore exits without relinquishing con- 
trol properly; i.e., without issuing a waitsem on the semaphore. 

A name file: 

A name file (semaphore, shared data, etc.) was specified when not 
expected. 

No message of desired type: An attempt was made to receive a mes- 
sage of a type that does not exist on the specified message queue 
[see msgop(S)]. 

Identifier removed: 

This error is returned to a process that resumes execution due to 
the removal of an identifier from the file system’s 
name space; see msgctl(S)y semctl(S), and shmctHS). 

No record locks available: 

In fcntl(S) the setting or removing of record locks on a file cannot 
be accomplished because there are no more record entries left on 
the system. 

Channel number out of range 
Level 2 not synchronized 
Level 3 halted 
Level 3 reset 
Link number out of range 
Protocol driver not attached 
No CSI structure available 
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Level 2 halted 

Deadlock situation detected/ avoided 

A deadlock situation was detected and avoided. This error pertains 
to file and record locking. 

No record locks available 

Bad exchange descriptor 

Bad request descriptor 

Message tables full 

Inode table overflow 

Bad request code 

Invalid slot 

File locking deadlock 

Bad font file format 

Not a stream device 

A putmsgiS) or getmsg{S) system call was attempted on a file 
descriptor that is not a STREAMS device. 

No data available 

Timer expired 

The timer set for a STREAMS ioctl(S) call has expired. The cause 
of this error is device specific and could indicate either a hardware 
or software failure, or perhaps a timeout value that is too short for 
the specific operation. The status of the ioctl(S) operation is 
indeterminate. 

Out of stream resources 

During a STREAMS open(S), either no STREAMS queues or no 
STREAMS head data structures were available. 

Machine is not on the network 

This error is Remote File Sharing (RFS) specific. It occurs when 
users try to advertise, unadvertise, mount, or unmount remote 
resources while the machine has not done the proper startup to 
connect to the network. 

Package not installed 

This error occurs when users attempt to use a system call from a 
package which has not been installed. 
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Object is remote 

This error is RFS specific. It occurs when users try to advertise a 
resource which is not on the local machine, or try to 
mount/unmount a device (or pathname) that is on a remote ma- 
chine. 

Link has been severed 

This error is RFS specific. It occurs when the link (virtual circuit) 
connecting to a remote machine is gone. 

Advertise error 

This error is RFS specific. It occurs when users try to advertise a 
resource which has been advertised already, or try to stop the RFS 
while there are resources still advertised, or try to force unmount a 
resource when it is still advertised. 

Srmount error 

This error is RFS specific. It occurs when users try to stop RFS 
while there are resources still mounted by remote machines. 

Communication error on send 

This error is RFS specific. It occurs when trying to send messages 
to remote machines but no virtual circuit can be found. 

Protocol error 

Some protocol error occurred. This error is device specific, but is 
generally not related to a hardware failure. 

Multihop attempted 

This error is RFS specific. It occurs when users try to access 
remote resources which are not directly accessible. 

Not a data message 

During a read{S\ getmsg(S\ or ioctl(S) I_RECVFD system call to a 
STREAMS device, something has come to the head of the queue 
that can’t be processed. That something depends on the system 
call: 

readiS) - control information or a passed file descriptor. 
getmsg(S) - passed file descriptor. 
ioctl(S) - control or data information. 

Name not unique on network 

File descriptor in bad state 

Remote address changed 

Cannot access a needed shared library 

Trying to exec(S) an a.out that requires a shared library (to be 
linked in) and the shared library doesn’t exist or the user doesn’t 
have permission to use it. 
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Accessing a corrupted shared library 

Trying to exec(S) an a.out that requires a shared library (to be 
linked in) and exec(S) could not load the shared library. The shared 
library is probably corrupted. 

Trying to exec(S) an a.out that requires a shared library (to be linked 
in) and there was erroneous data in the .lib section of the a.out. The 
.lib section tells exec(S) what shared libraries are needed. The 
a.out is probably corrupted. 

Attempting to link in more shared libraries than system limit 

Trying to exec(S) an a.out that requires more shared libraries (to be 
linked in) than is allowed on the current configuration of the sys- 
tem. See the System Administrator’s Guide. 

Cannot exec a shared library directly 

Trying to exec(S) a shared library directly. This is not allowed. 

Driver Messages 



The following messages are different from kernel messages in that 
they are generated by the device drivers for the various hardware sup- 
ported under Altos UNIX System V. The source of the message can be 
determined by checking the label field of the message. 



Console Driver Messages 

console: WARNING :Kemel messages lost on non-text screen 
(also check /usr/adm/messages) 

Kernel messages were lost while the console was in graphics 
mode and did not appear. Check the last lines of /usr/adm/mes- 
sages to find the messages. 

console: WARNING :Too many keyboard groups 

There are more video devices attached to your system than your 
kernel is designed to support. 



Irwin Driver Messages 

IRWIN:ERROR:Tape bad block table was not successfully read. 

When the tape device is open the bad block table is read into 
memory. This messages indicates that the read did not work 
correctly. 

IRWIN:ERROR:Tape is not formatted. 

The tape must be formatted before use. 
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IRWIN:ERROR:Tape is write protected. 

The write protect tab must be removed for use. 

IRWIN:ERROR:Cannot write to DC 1000 cartridge. 

Only Irwin model 110 or 125 drives can write to DCIOOO car- 
tridges. 

IRWIN:ERROR:Not enough memory for mini-cartridge; retrying... 

The Irwin is waiting for enough user memory to become avail- 
able to use the device. 

IRWIN:ERROR:Not enough memory for mini-cartridge; open failed. 
The Irwin did not get enough memory to be able to use the de- 
vice after several retries. 

IRWIN:ERROR:Tape write error. 

A write attempt was unsuccessful for an unknown reason. 

IRWIN:ERROR:Tape verify error. 

A verify attempt was unsuccessful for an unknown reason. 

IRWIN:ERROR:Tape read error. 

A read attempt was unsuccessful for an unknown reason. 

IRWIN:ERROR:Tape uncorrectable ECC error. 

An uncorrectable ECC memory error has occurred, check your 
hardware for defective chips. 

IRWIN:ERROR:Cannot format DCIOOO cartridge. 

Only Irwin model 110 or 125 drives can write to DCIOOO car- 
tridges. 

IRWIN:ERROR:Bad state:«wm 

Unknown state in the interrupt routine. 

IRWIN:ERROR:DMA boundary error - start address: w«m ending 
addressrnwm 

Device tried to transfer data from a buffer that crosses a 64k 
boundary. 



Cartridge Driver Messages 

CT:ERROR:Tape controller (type=nam^) not found 

The controller specified in in the file lusr/syslio/ ctconf.asm was 
not found. 

CT:ERROR:Cartridge tape is write protected 

You must remove the write protect tab from the cartridge before 
use. 
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CT:ERROR:system too busy for efficient tape use 

There is not enough user memory available to allow the device 
to work. 

CT:WARNING:attempted to free invalid buffer 

The driver attempted free a buffer that was not active. The buffer 
must be activated before use. 



SCSI Driver Messages 

scsi:ERROR:No controller response :num 

Requested controller is not present on SCSI bus mm. Check 
your system setup and connections. 

scsi:ERROR:CTLR mm LUN mm not attached 

Requested unit not present on controller. Check your system 
setup. 

scsi:ERROR:CTLR mm LUN nMmiinvalid type <mm>, 

Requested unit is not a disk or tape. Disk and tape and printer 
are currently the only supported SCSI devices. 

scsi:ERROR:CTLR mm LUN nwm:device not ready, ctlr, x); 
Requested device is busy. 

scsi:ERROR:adstrategy:device/type error OxtypelOxtype 

Internal error - open device is not disk, tape or printer. 

scsi:ERROR:adioctl:ADMODESENSE rc num host mm unit mm 
ioctl sense command did not complete as expected. 

scsi:WARNING:adioctl:ADEXECUTE rc num host num unit num 
ioctl execute command did not complete as expected. 

scsi:INFO:adioctl:nww reassigned 

ioctl bad block mapping completed (done in pairs) 

scsi:WARNING:adsetparam:ADMODESENSE rc num host num unit 
num 

Mode sense command did not complete as expected. 

scsi:ERROR:adgetcdb:unsupported command num 
Internal error - unexpected command. 

scsi:WARNING:adintr:adapter num SR_DETECTED status=nMw, 
intT=num 

SCSI reset detected. 

scsi:WARNING:Unexpected MBI status num 
Unexpected condition after interrupt. 
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scsi:WARNING:ad_sndcmd:unexpected port status = mm 
Unable to send command to adapter. 

scsi:ERROR:adpresent:Adapter num internal failurernwm 
Adapter returned bad status on initialization. 

scsi:ERROR:on disk dtw=numlnum ha=num id=num lun=nwm 
block=nwm sector=nwm, cylinder/head = numlnum 
Disk I/O failure. 

scsi:ERROR:on tape ha=nMm id=^num lun=nM/n hst num ust num 
AHA-1540 cmd :num [num ...] 

AHA- 1540 sense :num [num ...] 

Tape I/O failure; followed by one of these messages; 

end of tape 

tape is write protected 

wrong record length 



Disk Driver Messages 

disk:ERROR:Diskinfo table overflow 

Too many disk drives in use - reconfigure kernel to increase the 
available number of disks. 

disk:ERROR:Invalid partition sector on hard disk 

Master boot block on disk is unrecognizable. Run fsck(ADM). 



Floppy Driver Messages 

floppy : WARNING :CMOS indicates no diskette drives installed 
Configuration memory invalid - run your DOS SETUP disk. 

floppy: WARNING ‘.CMOS indicates diskette drive num not present 
Configuration memory invalid - run your DOS SETUP disk. 

floppy;ERROR:fdnwm being formatted 
The floppy drive is in use. 

floppy:ERROR:disk is write protected 

The disk cannot be written because it is protected. 

floppy:ERROR:on dev (numlnum), block=wMwi cmd=num status=nwm 
Floppy I/O failure, possibly followed by the message: 
insert disk or close floppy door 
if appropriate. 

floppy : WARNING :cmd result error 
I/O error on the floppy drive. 
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VPIX Messages 

VPIXxommand completed unexpectedly 
Process terminated prematurely. 



OMTI Driver Messages 

omti:ERROR:cannot allocate a GDT descriptor 

Internal error - kernel dscralloc routine failed. 

omti:ERROR:unit=nwm controller not configured 

Internal error - driver open failed to identify disk type. 

omti: WARNING :already busy 

Internal error - omtistart called for a busy drive. 

omti:ERROR:unknown command(nwm), bp->b_cmd 

Internal error - omtistart encountered an unrecognized com- 
mand. 

omti:ERROR:command setup failed 

Controller failed to accept command. 

omti: WARNING :non-omti interrupt (num), omti_status 

Controller did not signal an interrupt when an interrupt was 
received. 

omti: WARNING lunexpected omti interrupt (mm), omti_status 

Internal error - no pending command when interrupt received. 

omti:WARNING:still busy 

Controller still busy after generating an interrupt. 

omti:ERROR:during omti_sense 

Interrupt received during an OMTI sense command. 

omti :ERROR :initialization failure 

Error indicated during an initialization. 

omti ‘.ERROR: sense command setup failed 

Controller failed to accept setup command. 

omti:ERROR:minor=nwm, b\ock=num, errtype=nMm, code=nwm, 
unit=nwm [sector=nwm, cylinder/head=/zwm/nwm, ] <message> 
Disk I/O failure. <message> is one of: 

No error or no sense information. 

No Index, 

No Seek/Command Complete, 

Write/Drive Fault, 

Drive Not Selected/Not Ready, 
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No Track zero or Cylinder zero found. 

Multiple Drives Selected, 

Seek/Command in progress. 

Cartridge Changed 
ID CRC, 

Uncorrectable Data ECC, 

ID Address Mark Not Found, 

Data Address Mark Not Found, 

Sector Not Found, 

Seek Error, 

Sequence/DMA, 

Write Protected, 

Correctable ECC, 

Bad Track Encountered, 

Illegal Interleave Factor, 

Unknown Error, 

Ilegal Access To An Alternated Track/Unable to Read the Alternate 
Track Address, 

Alternate of Bad Track Already Assigned, 

No Alternate Track Found, 

Illegal Alternate Track Address 
Invalid Command, 

Illegal Disk Address, 

Illegal Function for Drive Type, 

Volume Overflow 
RAM error, 

EPROM Checksum/Intemal Diagnostic error 
Error with unknown type or code 

omti:ERROR:controller already in select state 

Internal error - controller busy when sending command. 

omti:ERROR:cannot enter command phase 

Controller failed to accept select command. 

omti:ERROR:C_D bit stuck off 

Controller failed to indicate readiness for command. 

omti:ERROR:OMTI_BUSY bit still stuck on 
Controller failed to obey reset command. 

omti:INFO:unloading all requests 

Preparing for manual reset because programmed reset did not 
work. 

omti:WARNING:colliding polling routines ... 

Internal error - multiple instances of omtipoll. 

omti:ERROR:timed out 

Expected interrupt did not arrive. 
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omti:ERROR:please use sfmt to modify disk parameters 

Attempt to write disk characteristics directly with DIOWDISK 
ioctl. 



Serial Driver Messages 

serial:ERROR:Garbage or loose cable on dev num, port shut down 

Too many interrupts were received together. Check your con- 
nections. 



Winchester Driver Messages 

wd:ERROR:on fixed disk 6t\-numlmm block=nMm cmd-num 
status=nwm sector=nwm, cylinder/head = numlnum 
Disk I/O failure. 



Event Driver Messages 



event:ERROR:event channel full 

There are no more devices available in the event queue. 



event:ERROR:event table full 

All of the system’s event queues are opened. 



Keyboard Driver Messages 

kb:ERROR:keyboard is in an unknown mode 

The keyboard has been set in an invalid mode through an ioctlO. 
The only valid keyboard modes are XT (0) and AT(1). 



Notes 



Not all messages appear on all maehines. Some messages are pro- 
cessor dependent. 
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mestbl 

create a messages locale table 

Syntax 

mestbl [ specfile ] 

Description 



The Utility mestbl is provided to allow LC MESSAGES locales to be 
defined. It reads in a specification file (or standard input if specfile is 
not defined), containing a definition for a particular locale’s response 
strings to yes/no queries, and produces a concise format table file, to 
be read by setlocaleiS), 

The response strings may be specified as a string held within double 
quotes or as a series of characters which are specified in one of six dif- 
ferent ways (the following examples all specify the ASCII character 
’A’): 



65 - decimal 

0101 - octal 

0x41 - hexadecimal 

’A’ - quoted character 

MOr -quoted octal 

’\x41’ - quoted hexadecimal 

or a combination of both methods, for example: 
’y’ ”es" 



is identical to: 



”yes" 

To specify the response strings, the above string definitions must be 
preceded by the keyword YESSTR= for affirmative responses, and 
NOSTR= for negative responses. 

All characters following the hash character are treated as a comment 
and ignored up to the end of the line, unless the hash is within a 
quoted string. 

The concise format locale table is placed in a file named messages in 
the current directory. This file should be copied or moved to the 
correct place in the setlocale (S) file tree (see locale (M)). To prevent 
accidental corruption of the output data, the file is created with no 
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write permission; if the mestbl utility is run in a directory containing a 
write-protected “messages” file, the utility will ask if the existing file 
should be replaced - any response other than “yes” or “y” will cause 
mestbl to terminate without overwriting the existing file. 

See Also 



chrtbl(M), montbl(M), coltbl(M), locale(M), numtbl(M), timtbl(M), 
setlocale(S) 

Diagnostics 



All error messages printed are self explanatory. 

Vaiue Added 



mestbl is an extension of AT&T System V provided in Altos UNIX 
System V. 



March 12, 1990 



MESTBL-2 







MONTBL(M) 



MONTBL(M) 



montbl 

create a currency locale table 

Syntax 

montbl [ specfile ] 

Description 



The Utility montbl is provided to allow new LC_MONETARY locales 
to be defined; it reads a specification file, containing a definition of 
the currency symbol for a particular locale, and produces a binary 
table file, to be read by setlocale (S), which determines the behavior of 
the nljanginfo (S) routine. 

The information supplied in the specification file consists of a line in 
the following format: 

CRNCYSTR = string 

The “ = ” can be separated from the keyword and string fields by 
zero or more space or tab characters. 

The string is a sequence of characters surrounded by quotes ("). The 
first character of the string should be if the symbol is to precede 
the currency value, or if it should appear after the value. Charac- 
ters within the string can be specified both literally and using “ \ ” 
escapes; the following three strings are equivalent: 

"+DM" literal 

”-h\x 44M" hexadecimal escapes 

"+D\115" octal escapes 

All characters following a hash ( # ) are treated as a comment and 
ignored up to the end of the line, unless the hash is within a quoted 
string. 

The binary table output is placed in a file named currency , within the 
current directory. This file should be copied or linked to the correct 
place in the setlocale file tree (see locale (M)). To prevent accidental 
corruption of the output data, the file is created with no write permis- 
sion; if the montbl utility is run in a directory containing a write- 
protected currency file, the utility will ask if the existing file should be 
replaced - any response other than “yes” or “y” will cause montbl to 
terminate without overwriting the existing file. 
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If the specfile argument is missing, the specification information is 
read from the standard input. 

See Also 



chrtbl(M), locale(M), msgtbl(M), nl_langinfo(S), numtbl(M), 
setlocale(S), timtbl(M) 

Diagnostics 



If the input table file cannot be opened for reading, processing will ter- 
minate with the error message, “Cannot open specification file”. 

Any lines in the specification file which are syntactically incorrect, or 
contain an unrecognized value instead of CRNCYSTR will cause an 
error message to be issued to the standard error output, specifying the 
line number on which the error was detected. The line will be 
ignored, and processing will continue. 

If the output file, currency y cannot be opened for writing, processing 
will terminate with the error message, “Cannot create table file”. 

Any error conditions encountered will cause the program to exit with 
a non-zero return code; successful completion is indicated with a zero 
return code. 

Value Added 



montbl is an extension of AT&T System V provided in Altos UNIX 
System V. 
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mscreen 

serial multiscreens utility 

Syntax 

mscreen [ -s ] [ -n number ] [ -t ] 

Description 



mscreen allows a serial terminal to have multiple login screens similar 
to the multiscreenQA) console. 

Note: For full mscreen support the terminal must have the ability to 
switch internal screen pages on command and it must retain a separate 
cursor position for each screen page. 

The options are used as follows: 

-s Silent mode. This flag suppresses the startup messages, 

and on “dumb” terminals it suppresses the screen switch 
messages 

-n Selects the number of serial multiscreens desired up to the 

maximum defined for the terminal type. 

-t Disables the transparent tty checking, mscreen normally 

exits silently if the termind device name starts with the 
characters “ttyp”. Device names beginning with “ttyp” 
are used as slave devices for mscreen. The correct names 
for the master tty devices begin with “ptyp”. 

mscreen can be used on both “smart” and “dumb” terminals. 
Although it is optimized to take advantage of smart terminals with 
screen memory, mscreen also works on dumb terminals, although the 
screen images are not saved during screen changes, mscreen also sup- 
ports terminals with two (or more) serial ports that are connected to 
different computers. 

mscreen is designed to be invoked from the .profile or .login files. Use 
mscreen in place of the SHELL variable so that serial multiscreeiis 
can be automatic at login time. The “stop” and “quit” keys allow 
you to logout from all screens with a single keystroke. 

Configuration 



mscreen determines the terminal type of the terminal it is invoked 
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from by examining the environment variable TERM, mscreen looks 
in /etc/mscreencap or in the filename contained in the environment 
variable MSCREENCAP to get the capabilities for the terminal type. 

The pseudo terminals assigned to the user are automatically deter- 
mined at startup by mscreen. Manual assignment of ttys can be 
accomplished by creating a file in the user’s home directory called 
.mscreenrc. 



mscreencap format 

mscreencap contains an entry for each terminal type supported. An 
entry may have several names if the support for several terminal types 
are the same. Within an entry are the key mappings for each potential 
pseudo terminal. Each pseudo terminal has a help key string, an input 
string (the sequence generated by the key that selects this screen), and 
an optional output string (the sequence to send to the terminal that 
will cause a page switch). The input and output strings are in a 
termcap like format; (the backslash and caret are special lead in 
(escape) characters) 

\nnn an octal number, one to three digits are allowed 

\n newline 

\r carriage return 

\t tab 

\b backspace 

\f form feed 

\E escape (hex lb octal 33). 

\ enter backslash as a data character 

X'' enter caret as a data character 

\"X ctrl-X where X can be: @ABCDEFGHIJKLM- 
NOPQESTUVWXYZ[]^_ effectively the caret 
can generate hex 01 through hex If. 

If a terminal type has no output strings then it is assumed to be a dumb 
terminal that does not have multiple internal memory pages. 

There are five special entries that allow the user to define keys to sup- 
port the other functions of mscreen. They are the help key (which 
prints a list of all of the keys that are currently available and their 
functions), the who key (prints the name of the current screen), the 
stop key (terminates mscreen and returns a good (zero) shell return 
code), and quit key (terminates mscreen and returns a bad (non-zero) 
shell return code and the dummy entry that is used for terminals with 
multiple ports. 
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The format is: 

#this is a comnnent and may only appear between entries 
entryname | aliasl 1 aliasl . . . | aliasn : 

: specialname, helpname, inputstring, pageselectstring : 

: specialname, helpname, inputstring, pageselectstring : 
entryname | aliasl | aliasl . . . | aliasn : 

: specialname, helpname, inputstring, pageselectstring : 

: specialname, helpname, inputstring, pageselectstring : 

The specialname is empty for real screen entries. See the provided 
/etc/mscreencap for examples. 



.mscreenrc format 



.mscreenrc contains a list of ttynames if the user wants to allocate a 
fixed set of ttys for use: 



ttypO 

ttypl 

ttypn 



Shell return codes and auto login/logout 

mscreen exits with a bad (non-zero) return code if there is an error or 
when the “quit” key is pressed. The “stop” key causes mscreen to 
exit with a good (zero) return code. This allows users to place mscreen 
in the .login or .profile files. The .login or .profile files should set up an 
automatic logout if the mscreen return code is good (zero). The fol- 
lowing is a csh sample invocation of mscreen for a .login file: 

mscreen -n 4 
if ($status == 0) logout 

The single key logout feature of mscreen works as if a normal logout 
was entered on each pseudo- terminal. A hangup signal is sent to all of 
the processes on all the pseudo terminals. 



Multiple Port Option 

mscreen provides a dummy entry type. It allows mscreen to be placed 
in an inactive state while the user uses his terminal to converse 
through another (physical) io port to another computer, see the pro- 
vided /etc/w.ycree«termmap for an example. To be used, you must 
take the example and configure it for your needs. 
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mscreen Driver 

The mscreen driver is already installed in the Altos UNIX System V 
kernel with eight pseudo terminals available for use. You must enable 
a pseudo terminals to use it. See the link-kit instructions for relinking 
the kernel to have more available pseudo terminals. 

Notes 



mscreen has a VTIM timeout of 1/5 second for input strings. 

mscreen has a limit of twenty multiscreens per user. 

You should not switch screen pages in mscreen when output is occur- 
ring because if an escape sequence is cut in half it may leave the ter- 
minal in an indeterminate state and distort the screen image. 

Terminals that save the cursor location for each screen often do not 
save states such as insert mode, inverse video, and others. For exam- 
ple, you should not change screens if you are in insert mode in vi, and 
you should not change screens during an inverse video output 
sequence. 

For inactive screens (screens other than the current one) mscreen 
saves the last 2048 characters of data (2K). Data older than this is 
lost. This limit occasionally results in errors for programs that require 
a memory of more data than this. The user-defined screen redraw key 
restores the screen to normal appearance. 

mscreen depends on the pseudo terminal device names starting with 
ttyp for the slave devices and ptyp for the master devices. The number 
of trailing character in the device name is not significant. 

See Also 



multiscreen(M), enable(C), “Adding Ports, Terminals, and Modems” 
in the System Administrator's Guide 

Value Added 



mscreen is an extension of AT&T System V provided in Altos UNIX 
System V. 
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multiscreen 

multiple screens (device files) 
Syntax 



alt-Fn 

alt-ctrl-Fn 

alt-shift-Fn 

alt-ctrl-shift-Fn 

Description 



With the multiscreen feature, a user can access up to twelve different 
“screens,” each corresponding to a separate device file. Each screen 
can be viewed one at a time through the primary monitor video dis- 
play. 

The number of screens on a system depends upon the amount of mem- 
ory in the computer. The system displays the number of enabled 
screens during the boot process. 

Access 



To see the next consecutive screen, enter: 

Ctrl-PrtSc 

To move to any screen from any other screen, enter: 

alt-Fn or alt-ctrl-F« or alt-shift-Fiz 
alt-F/i or alt-ctrl-F« (screens 1-12) 
alt-shift-F« or alt-ctrl-shift-Fn (screens 1 1-16, 7-12) 

where n is the number of one of the “F” function keys on the primary 
monitor keyboard. For example: 

alt-F2 

selects tty02, and all output in that device’s screen buffer is displayed 
on the monitor screen. 

The second form (using the SHIFT key) permits access to screens 1 1 
and 12 on keyboards that have only ten function keys. It is also possi- 
ble to configure the kernel for up to 16 screens, but 12 is the default. 
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The function key combinations used to display the various screens are 
defined in the keyboard mapping file. The /usr/lib/keyboard/keys or 
other mapkey^ADM) file can be modified to allow different key com- 
binations to change multiscreens. Use the mapkey utility to create a 
new keyboard map. 

Files 



/dev/tty[01-12] multiscreen devices 

(number available depends on system 
memory) 



See Also 



mapkey(ADM), keyboard(HW), screen(HW), serial(HW), stty(C) 

Notes 



Any system error messages are normally output on the console device 
file (/dev/console). When an error message is output, the video dis- 
play reverts to the console device file, and the message is displayed 
on the screen. The console device is the only teletype device open 
during the system boot sequence and when in single user, or system 
maintenance mode. 

Limitations to the number of multiscreens available on a system does 
not affect the number of serial lines or devices available. See 
serial (M) for information on available serial devices. 

Note that the keystrokes given here are the default, but your keyboard 
may be different. If so, see keyboard(M) for the appropriate substi- 
tutes. Also, any key can be programmed to generate the screen 
switching sequences by using the mapkey utility. 

Value Added 



multiscreen is an extension of AT&T System V provided in Altos 
UNIX System V. 
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numtbl 

create a numeric locale table 
Syntax 

numtbl [ table__file ] 

Description 



This Utility will create a numeric locale table to be interpreted by the 
setlocale (S) system call. 

The table Jile contains information about the numeric locale in a user 
readable form. 

At present, two pieces of information can be supplied. These are: the 
character to be used as a decimal place marker (radix character), and 
the character to be used as a thousands delimiter, for example the 
commas in 1,000,000. To specify these, there must be lines, in the 
table file, of the form: 

DECIMAL=d 

THOUSANDS=t 

Where “d” is the character to be used as the decimal place mark and 
“t” is the character to be used as the thousands delimiter. The char- 
acters “d” and “t” may be specified in six different ways. The fol- 
lowing lines show different formats for the letter b. 



98 


- decimal 


0142 


- octal 


0x62 


- hexadecimal 


’b’ 


- quoted character 


’N0142’ 


- quoted octal 


V62’ 


- quoted hexadecimal 



Any line starting with a hash (“#”) is treated as a comment. 

The output is a file, called numeric y which is placed in the current 
directory. This file is in a form which can be interpreted by the 
setlocale(S) system call. For more information on where this file 
should be placed, please see locale(M). 

If no table file is specified, the information is taken from the standard 
input. The format of the information is identical. 
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If either DECIMAL or THOUSANDS is not specified, its value will 
default to or respectively. 

See Also 



locale(M), environ(M) 

Diagnostics 



Any lines of input which are in the wrong format will cause a warning 
to be issued on the terminal, but will not terminate the program. 

“Character syntax error” will be issued on the terminal if the format 
of the character specification does not match one of those specified 
above. The program will then terminate. 

If the input table file cannot be opened for reading, the program will 
also terminate with the error message, “Cannot open table file”. 

If the output file, numeric, cannot be opened for writing, the program 
will terminate with the error message, “Cannot create numeric locale 
file”. 

Notes 



The thousands delimiter is not currently used within any of the stan- 
dard Altos UNIX System V libraries or utilities, although it can be 
accessed by application programs using the nlJanginfo(^ function. 

The string RADIXCHAR may be used as an alternative to DECIMAL , 
and THOUSEP as an alternative to THOUSANDS , if required. These 
alternatives are provided for consistency with the identifiers used by 
nl_langinfo(S). 

Value Added 



numtbl is an extension of AT&T System V provided in Altos UNIX 
System V. 
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powerfail 

perform power failure shutdown service 

Syntax 

/etc/powerfail [-t seconds] 

Description 



If the system is equipped with an uninterruptible power supply (UPS), 
when init(}A) receives the power failure signal, it invokes 
I etc! powerfail (via inittab(}A)) to shut down various system services 
during a power failure. 

The specific system services to be shut down are specified by shut- 
down shell scripts in the appropriate /etc/rc.^.d directory. These shell 
scripts must have filenames that begin with the letter For example, if 
the current run level is 2 (multi-user mode), all /etc/rc2.d/P* scripts 
will be executed. 

A timeout mechanism is provided in case a particular shut-down script 
does not exist. In such cases, powerfail will abort that script and con- 
tinue to the next one. The timout value in seconds can be specified on 
the command line with the -t option. If no -t option is used, then there 
is no timeout. 

Files 



/etc/rc?.d/P* 

/etc/inittab 

/etc/conf/cf.d/init.base 

See Also 



init(M), upsconfig(ADM) 

Value Added 



! etc! powerfail is an extension of AT&T System V provided in Altos 
UNIX System V. 
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profile 

sets up an environment at login time 
Description 



The optional file, .profile, permits automatic execution of commands 
whenever a user logs in. The file is generally used to personalize a 
user’s work environment by setting exported environment variables 
and terminal mode (see (M)). 

When a user logs in, the user’s login shell looks for .profile in the log- 
in directory. If found, the shell executes the commands in the file 
before beginning the session. The commands in the file must have the 
same format as if they were entered at the keyboard. Any line begin- 
ning with the number sign (#) is considered a comment and is ignored. 
The following is an example of a typical file: 

# Tell me when new mail comes in 
' MAIL=/usr/mail/myname 

# Add my /bin directory to the shell search sequence 
PATH=$PATH : $HOME/bin 

# Make some environment variables global 
export MAIL PATH TERM 

# Set file creation mask 
umask 22 

Note that the file /etc/profile is a system-wide profile that, if it exists, 
is executed for every user before the user’s .profile is executed. 

Files 



$HOME/.profile 

/etc/profile 

See Also 



env(C), login(M), mail(C), sh(C), stty(C), su(C), environ(M) 
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promain, nopromain 

restrict the execution domain of a program 

Syntax 

auths -r nopromain 

Description 



The promain feature allows you to control the damage an SUID pro- 
gram can do to your files. An SUID program starts execution with 
effective user ID equal to the owner of the SUID program file and real 
user ID equal to the invoker of the SUID program. On traditional 
UNIX systems, an SUID program has complete access to all files, pro- 
cesses, and IPC objects (collectively called resources ) to which the 
invoker or the owner has access, because the program can use 
setuid(S) to switch between the invoker and owner user ID. Outside a 
promain, this power is restricted to resources to which the invoker and 
the owner have access, as described in this section. 

The SUID feature is used when one user (or system function) needs to 
protect files from access except through a well-defined set of pro- 
grams. An example is the suite of line printer commands, which work 
with a set of configuration files, status files, and shell scripts to keep 
track of which print jobs are queued to which printers. Users and line 
printer administrators use several commands to submit and cancel 
jobs, change and query the status of printers, and add and remove 
printers from the system or from active duty. All printer files are 
owned by the pseudo user Ip , the user ID which is the owner of all 
files used by the line printer subsystem, including the printer special 
devices themselves. 

When you invoke the lp(C) command to print a file, the program can 
access the files in the database, but can also access files that you 
request to be printed because the program can setuid to your user ID to 
access your files. A malicious Ip program could just as easily look for 
protected files in your directory hierarchy and copy them to a place 
protected such that only Ip could read them. Thus, the fact that you 
trust Ip enough to run it as a program means that you trust that it will 
not abuse the power you give when you run it. 

If you run a SUID program on a trusted system and the promain ker- 
nel authorization is off, a promain is created, and the current directory 
is noted as the promain root. Files in the subtree starting at the 
promain root are said to be inside the promain, while files outside that 
subtree are said to be outside the promain. domains protect a user 
against a malicious SUID program by restricting the kinds of accesses 
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the program can do outside the promain when running as you (the 
invoker). When running with the invoker’s effective user ID outside 
the promain, the program can access files if both the invoker and the 
owner have access (public files). Inside the promain, the program has 
access according to the rules associated with normal UNIX systems. 

To run untrustworthy SUID programs with promain protection, do the 
following: 

1. Start a subshell without the nopromain authorization, as in this 
example: 

$ auths 

Kernel authorizations: nopromain, execsuid 

$ auths -r nopromain 
$ auths 

Kernel authorizations: nopromain 

2. Change directory to one in which you will place all files which you 
expect the program to modify, and put all the files the program 
needs there, as in the following example: 

$ cd txap 

$ cp path/fllel path/£ile2 . 

$ Is -Id . filel file2 

total 10 

drwxrwx 2 drb mktng 64 Jul 30 07:53 . 

-rw-rw 1 drb mktng 10345 Jul 30 07:52 filel 

-rw-rw 1 drb mktng 9200 Jul 30 07:52 filel 

$ pwd 

/usr/drb/tmp 

3. Run the program. In /usr/drb/tmp , the program has complete 
access to filel , file2 , and the /usr/drb/tmp directory. Assuming 
that all files owned by drb outside the /usr/drb/tmp directory are 
protected, the program has access only if drb allows public access. 

Note that promain protection is enforced for all system actions outside 
the promain when running under the effective user ID of the invoker. 
The program cannot read or write files unless they are accessible to 
the program owner and the invoker. The program cannot use 
chown(S) or chmod(S) on files outside the promain as drb because 
drb and the SUID program owner cannot possibly both own the file 
unless drb is the program owner as well. In addition, the program 
cannot link files outside the promain to a file inside the promain unless 
the file is accessible to both the invoker and the owner. This protects 
against a malicious program getting around promain protection by 
changing the search path used to access the file. 



What Promains Guard Against 

Promains were designed to guard against one specific type of Trojan 
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Horse attack, where another user supplies you with a SUID program 
which steals some of your files into a location or directory to which 
you do not have access. It also stops the common case of creating a 
program which is SUID to your user ID by using setuid(S) to: 

1 . Set the program’s effective user ID to you (the real user ID), 

2. Create a file (which sets you as the owner), and 

3. Change the program’s mode such that the SUID bit is on. 

Promains stop these attacks by only allowing file creation if both the 
invoker and the program owner are allowed an action. Thus, the pro- 
gram will only be able to access your public files (world or group 
readable) and will never be able to use the SUID attack to create a 
malicious program (e.g., a shell) which is SUID to you. If your file 
hierarchy is suitably protected, you can stop attempts to steal data or 
create damaging files (e.g., programs which have the same name as 
system programs which you execute because you have included the 
current directory in your search path). 



What Promains Do Not Guard Against 

Promains do not protect against running a SUID program which has 
access to public files or directories in your hierarchies. Neither do 
they protect against Trojan Horses which are not SUID. A program 
which is not SUID is effectively given access to any objects to which 
you have access. Thus, running a program which you do not trust is in 
effect giving your entire discretionary capability to that process. 
Always suspect a program which is given to you from someone whose 
motives you have no reason to trust. The newspapers today are full of 
stories of Trojan Horses and computer viruses (one specif case of a 
Trojan Horse) which were planted by someone who was able to 
arrange for a user to run a program which did something malicious. 

See Also 



auths(C), “Maintaining System Security” in the System 
Administrator’s Guide 
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restart 

perform power failure recovery service 
Syntax 

/etc/restart 

Description 



During a shutsave restart operation (see upsconfig{kY)M)\ m/7(M) 
invokes letcl restart (via inittab(F)) to restart various system services. 

The specific system services to be restarted are specified by start-up 
shell scripts in the appropriate /etc/rc.^.d directory. These shell scripts 
must have filenames that begin with the letter For example, if the 
current run level is 2 (multi-user mode), all /etc/rc2.d/P* scripts will 
be executed. 

Files 



/etc/rc?.d/R* 

/etc/inittab 

/etc/conf/cf.d/init.base 

See Also 



init(M), upsconfig(ADM) 

Value Added 



letcirestart is an extension of AT&T System V provided in Altos 
UNIX System V. 
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rmb 

remove extra blank lines from a file 

Syntax 

/usr/bin/rmb 

Description 



lusribinfrmb acts as a filter to remove any series of blank lines greater 
than two lines in length. This means that all long sequences of blank 
lines will be reduced to two blank lines. This is particularly useful for 
cleaning nrofF output of blank lines before putting the output in a file. 

See Aiso 



man(C), your nroff documentation 

Notes 



Because lusribinirmb is a filter, it must be used within a piped com- 
mand sequence as shown in the following examples: 

cat infile I /usrA>in/rmb > outfile 

nroff infile I /usr/bin/rmb > outfile 

It cannot be used in the form /usr/bin/rmb filename. 

Also note that Altos UNIX System V is not shipped with nrojf or other 
standard UNIX text formatting utilities. These must be purchased 
separately. 
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Stream io 

STREAMS iocti commands 

Syntax 



#include <stropts.h> 

int iocti (fildes, command, arg) 

int fildes, command; 

Description 



STREAMS [see intro(S)] iocti commands are a subset of ioctl(S) sys- 
tem calls which perform a variety of control functions on streams. 
The arguments command and arg are passed to the file designated by 
fildes and are interpreted by the stream head. Certain combinations of 
these arguments may be passed to a module or driver in the stream. 

fildes is an open file descriptor that refers to a stream, command 
determines the control function to be performed as described below. 
arg represents additional information that is needed by this command. 
The type of arg depends upon the command, but it is generally an 
integer or a pointer to a command-specific data structure. 

Since these STREAMS commands are a subset of iocti, they are sub- 
ject to the errors described there. In addition to those errors, the call 
will fail with errno set to EINVAL, without processing a control func- 
tion, if the stream referenced by fildes is linked below a multiplexer, 
or if command is not a valid value for a stream. 

Also, as described in iocti, STREAMS modules and drivers can detect 
errors. In this case, the module or driver sends an error message to the 
stream head containing an error value. This causes subsequent system 
calls to fail with errno set to this value. 

Command Functions 



The following iocti commands, with error values indicated, are appli- 
cable to all STREAMS files: 

I_PUSH Pushes the module whose name is pointed to by arg 

onto the top of the current stream, just below the 
stream head. It then calls the open routine of the 
newly-pushed module. On failure, errno is set to one 
of the following values: 
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[EINVAL] Invalid module name. 

[EFAULT] arg points outside the allocated 

address space. 

[ENXIO] Open routine of new module failed. 

[ENXIO] Hangup received on fildes, 

LPOP Removes the module just below the stream head of 

the stream pointed to by fildes, arg should be 0 in an 
I_POP request. On failure, errno is set to one of the 
following values: 

[EINVAL] No module present in the stream. 

[ENXIO] Hangup received on fildes. 

I_LOOK Retrieves the name of the module just below the 
stream head of the stream pointed to by fildes, and 
places it in a null terminated character string pointed 
at by arg. The buffer pointed to by arg should be at 
least FMNameSZ+1 bytes long. An [#include 
<sys/conf.h>] declaration is required. On failure, 
errno is set to one of the following values: 

[EFAULT] arg points outside the allocated 
address space. 

[EINVAL] No module present in stream. 

LFLUSH This request flushes all input and/or output queues, 
depending on the value of arg. Legal arg values are: 

FLUSHR Flush read queues. 

FLUSHW Flush write queues. 

FLUSHRW Flush read and write queues. 

On failure, errno is set to one of the following values: 

[ENOSR] Unable to allocate buffers for flush 
message due to insufficient STREAMS 
memory resources. 

[EINVAL] Invalid arg value. 

[ENXIO] Hangup received on fildes. 
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I_SETSIG Informs the stream head that the user wishes the ker- 
nel to issue the SIGPOLL signal [see signal{S) and 
sigset(S)] when a particular event has occurred on the 
stream associated with fildes. LSETSIG supports an 
asynchronous processing capability in STREAMS. 
The value of arg is a bitmask that specifies the events 
for which the user should be signaled. It is the 
bitwise- OR of any combination of the following con- 
stants; 

SJNPUT A non-priority message has arrived on 
a stream head read queue, and no 
other messages existed on that queue 
before this message was placed there. 
This is set even if the message is of 
zero length. 

S_HIPRI A priority message is present on the 

stream head read queue. This is set 
even if the message is of zero length. 

S_OUTPUT The write queue just below the stream 
head is no longer full. This notifies 
the user that there is room on the 
queue for sending (or writing) data 
downstream. 

S_MSG A STREAMS signal message that con- 

tains the SIGPOLL signal has reached 
the front of the stream head read 
queue. 

A user process may choose to be signaled only of 
priority messages by setting the arg bitmask to the 
value S_HIPRI. 

Processes that wish to receive SIGPOLL signals must 
explicitly register to receive them using I_SETSIG. If 
several processes register to receive this signal for the 
same event on the same Stream, each process will be 
signaled when the event occurs. 

If the value of arg is zero, the calling process will be 
unregistered and will not receive further SIGPOLL sig- 
nals. On failure, errno is set to one of the following 
values: 

[EINVAL] arg value is invalid or arg is zero and 
process is not registered to receive the 
SIGPOLL signal. 
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LGETSIG 



I_HND 



I_PEEK 



[EAGAIN] Allocation of a data structure to store 
the signal request failed. 

Returns the events for which the calling process is 
currently registered to be sent a SIGPOLL signal. The 
events are returned as a bitmask pointed to by arg, 
where the events are those specified in the description 
of I_SETSIG above. On failure, errno is set to one of 
the following values: 

[EINVAL] Process not registered to receive the 
SIGPOLL signal. 

[EFAULT] arg points outside the allocated 

address space. 

Compares the names of all modules currently present 
in the stream to the name pointed to by arg, and 
returns 1 if the named module is present in the stream. 
It returns 0 if the named module is not present. On 
failure, errno is set to one of the following values: 

[EFAULT] arg points outside the allocated 

address space. 

[EINVAL] arg does not contain a valid module 
name. 

Allows a user to retrieve the information in the first 
message on the stream head read queue without taking 
the message off the queue, arg points to a strpeek 
structure which contains the following members: 

struct strbuf ctlbuf ; 
struct strbuf databuf ; 
long flags; 

The maxlen field in the ctlbuf 2 ind databuf strbuf struc- 
tures [see getmsg(S)] must be set to the number of 
bytes of control information and/or data information, 
respectively, to retrieve. If the user sets flags to 
RS_HIPRI, I_PEEK will only look for a priority mes- 
sage on the stream head read queue. 

I_PEEK returns 1 if a message was retrieved, and 
returns 0 if no message was found on the stream head 
read queue, or if the RS_HIPRI flag was set in flags 
and a priority message was not present on the stream 
head read queue. It does not wait for a message to 
arrive. On return, ctlbuf specifies information in the 
control bufler, databuf specifies information in the 
data buffer, and flags contains the value 0 or 
RS_HIPRI. On failure, errno is set to one of the 
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LSRDOPT 



LGRDOPT 



LNREAD 



LFDINSERT 



following values: 

[EFAULT] arg points, or the buffer area specified 
in ctlbuf or databuf is, outside the 
allocated address space. 

[EBADMSG] Queued message to be read is not 
valid for I_PEEK 

Sets the read mode using the value of the argument 
arg. Legal arg values are: 

RNORM Byte-stream mode, the default. 

RMSGD Message-discard mode. 

RMSGN Message-nondiscard mode. 

Read modes are described in readiS). On failure, 
errno is set to the following value: 

[EINVAL] arg is not one of the above legal 
values. 

Returns the current read mode setting in an int pointed 
to by the argument arg. Read modes are described in 
read(S). On failure, errno is set to the following 
value: 

[EFAULT] arg points outside the allocated 

address space. 

Counts the number of data bytes in data blocks in the 
first message on the stream head read queue, and 
places this value in the location pointed to by arg. 
The return value for the command is the number of 
messages on the stream head read queue. For exam- 
ple, if zero is returned in arg, but the ioctl return value 
is greater than zero, this indicates that a zero-length 
message is next on the queue. On failure, errno is set 
to the following value: 

[EFAULT] arg points outside the allocated 

address space. 

Creates a message from user specified buffer(s), adds 
information about another stream and sends the mes- 
sage downstream. The message contains a control 
part and an optional data part. The data and control 
parts to be sent are distinguished by placement in 
separate buffers, as described below. 
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arg points to a strfdinsert structure which contains the 
following members: 

struct strbuf ctlbuf ; 
struct strbuf databuf ; 
long flags; 

int fildes; 

int offset; 

The len field in the ctlbuf strbuf structure [see 
putmsg(S)] must be set to the size of a pointer plus the 
number of bytes of control information to be sent with 
the message, fildes in the strfdinsert structure 
specifies the file descriptor of the other stream, offset, 
which must be word-aligned, specifies the number of 
bytes beyond the beginning of the control buffer where 
LFDINSERT will store a pointer. This pointer will be 
the address of the read queue structure of the driver 
for the stream corresponding to fildes in the strfdinsert 
structure. The len field in the databuf strbuf structure 
must be set to the number of bytes of data information 
to be sent with the message or zero if no data part is to 
be sent. 

flags specifies the tyj^ of message to be created. A 
non-priority message is created if flags is set to 0, and 
a priority message is created if flags is set to 
RS_HIPRI. For non-priority messages, LFDINSERT 
will block if the stream write queue is full due to 
internal flow control conditions. For priority mes- 
sages, LFDINSERT does not block on this condition. 
For non-priority messages, LFDINSERT does not 
block when the write queue is full and 0_NDELAY is 
set. Instead, it fails and sets errno to E AG AIN. 

LFDINSERT also blocks, unless prevented by lack of 
internal resources, waiting for the availability of mes- 
sage blocks in the stream, regardless of priority or 
whether 0_NDELAY has been specified. No partial 
message is sent. On failure, errno is set to one of the 
following values: 

[EAGAIN] A non-priority message was specified, 
the 0_NDELAY flag is set, and the 
stream write queue is full due to inter- 
nal flow control conditions. 

[ENOSR] Buffers could not be allocated for the 
message that was to be created due to 
insufficient STREAMS memory 
resources. 
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[EFAULT] arg points, or the buffer area specified 
in ctlbuf or databuf is, outside the 
allocated address space. 

[EINVAL] One of the following: fildes in the 
strfdinsert structure is not a valid, 
open stream file descriptor; the size of 
a pointer plus offset is greater than the 
len field for the buffer specified 
through ctlptr; offset does not specify 
a properly aligned location in the data 
buffer; an undefined value is stored in 
flags. 

[ENXIO] Hangup received on fildes of the ioctl 

call or fildes in the strfdinsert struc- 
ture. 

[ERANGE] The len field for the buffer specified 
through databuf does not fall within 
the range specified by the maximum 
and minimum packet sizes of the top- 
most stream module, or the len field 
for the buffer specified through data- 
buf is larger than the maximum con- 
figured size of the data part of a mes- 
sage, or the len field for the buffer 
specified through ctlbuf is larger than 
the maximum configured size of the 
control part of a message. 

LFDINSERT can also fail if an error message was 
received by the stream head of the stream correspond- 
ing to fildes in the strfdinsert structure. In this case, 
errno will be set to the value in the message. 

I_STR Constructs an internal STREAMS ioctl message from 

the data pointed to by arg and sends that message 
downstream. 

This mechanism is provided to send user ioctl requests 
to downstream modules and drivers. It allows infor- 
mation to be sent with the ioctl and will return to the 
user any information sent upstream by the downstream 
recipient. I_STR blocks until the system responds 
with either a positive or negative acknowledgment 
message or until the request "times out" after some pe- 
riod of time. If the request times out, it fails with 
errno set to ETIME. 
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At most, one I_STR can be active on a stream. Further 
I_STR calls will block until the active I_STR com- 
pletes at the stream head. The default timeout inter- 
val for these requests is 15 seconds. The 0_NDELAY 
[see open{S)] flag has no effect on this call. 

To send requests downstream, arg must point to a 
strioctl structure which contains the following mem- 
bers: 



int 


ic_cmd; 


/* 


downstream command 


*/ 


int 


ic_timout ; 


/* 


ACK/NAK timeout */ 




int 


ic_len; 


/* 


length of data arg 


*/ 


char 


*ic_dp; 


/* 


ptr to data arg */ 





ic cmd is the internal ioctl command intended for a 
downstream module or driver; and icjimout is the 
number of seconds (-1 = infinite, 0 = use default, >0 = 
as specified) an I_STR request will wait for ack- 
nowledgment before timing out. icjen is the number 
of bytes in the data argument and ic dp is a pointer to 
the data argument. The icjen field has two uses: on 
input, it contains the length of the data argument 
passed in, and on return from the command, it con- 
tains the number of bytes being returned to the user 
(the buffer pointed to by ic dp should be large enough 
to contain the maximum amount of data that any 
module or the driver in the stream can return). 



The stream head will convert the information pointed 
to by the strioctl structure to an internal ioctl com- 
mand message and send it downstream. On failure, 
errno is set to one of the following values: 

[ENOSR] Unable to allocate buffers for the ioctl 
message due to insufficient STREAMS 
memory resources. 

[EFAULT] arg points, or the buffer area specified 
by ic dp and icjen (separately for 
data sent and data returned) is, outside 
the allocated address space. 



[EINVAL] icjen is less than 0 or icjen is larger 
than the maximum configured size of 
the data part of a message or ic jimout 
is less than -1. 

[ENXIO] Hangup received on fildes. 



[ETIME] A downstream ioctl timed out before 

acknowledgment was received. 
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I.SENDFD 



LRECVFD 



An I_STR can also fail while waiting for an ack- 
nowledgment if a message indicating an error or a 
hangup is received at the stream head. In addition, an 
error code can be returned in the positive or negative 
acknowledgment message, in the event the ioctl com- 
mand sent downstream fails. For these cases, I_STR 
will fail with errno set to the value in the message. 

Requests the stream associated with fildes to send a 
message, containing a file pointer, to the stream head 
at the other end of a stream pipe. The file pointer cor- 
responds to arg, which must be an integer file descrip- 
tor. 

I_SENDFD converts arg into the corresponding system 
file pointer. It allocates a message block and inserts 
the file pointer in the block. The user id and group id 
associated with the sending process are also inserted. 
This message is placed directly on the read queue [see 
intro{S)\ of the stream head at the other end of the 
stream pipe to which it is connected. On failure, 
errno is set to one of the following values: 



[EAGAIN] 


The sending stream is unable to allo- 
cate a message block to contain the 
file pointer. 


[EAGAIN] 


The read queue of the receiving 
stream head is full and cannot accept 
the message sent by I_SENDFD. 


[EBADF] 


arg is not a valid, open file descriptor. 


[EINVAL] 


fildes is not connected to a stream 
pipe. 


[ENXIO] 


Hangup received on fildes. 



Retrieves the file descriptor associated with the mes- 
sage sent by an I_SENDFD ioctl over a stream pipe. 
arg is a pointer to a data buffer large enough to hold 
an strrecvfd data structure containing the following 
members: 

int fd; 

unsigned short uid; 
unsigned short gid; 
char fill [8]; 

fd is an integer file descriptor, uid and gid are the user 
id and group id, respectively, of the sending stream. 



March 15, 1989 



STREAMIO-9 




STREAMIO(M) 



STREAMIO(M) 



If 0_NDELAY is not set [see open{S)\, I_RECVFD will 
block until a message is present at the stream head. If 
0_NDELAY is set, I_RECVFD will fail with errno set 
to EAGAIN if no message is present at the stream 
head. 

If the message at the stream head is a message sent by 
an LSENDFD, a new user file descriptor is allocated 
for the file pointer contained in the message. The new 
file descriptor is placed in the/d field of the strrecvfd 
structure. The structure is copied into the user data 
buffer pointed to by arg. On failure, errno is set to one 
of the following values: 

[EAGAIN] A message was not present at the 
stream head read queue, and the 
0_NDELAY flag is set. 

[EBADMSG] The message at the stream head read 
queue was not a message containing a 
passed file descriptor. 

[EFAULT] arg points outside the allocated 
address space. 

[EMFILE] NOFiles file descriptors are currently 

open. 

[ENXIO] Hangup received on fildes. 

The following two commands are used for connecting and disconnect- 
ing multiplexed STREAMS configurations. 

I_LINK Connects two streams, where fildes is the file descrip- 

tor of the stream connected to the multiplexing driver, 
and arg is the file descriptor of the stream connected 
to another driver. The stream designated by arg gets 
connected below the multiplexing driver. I_LINK 
requires the multiplexing driver to send an ack- 
nowledgment message to the stream head regarding 
the linking operation. This call returns a multiplexer 
ID number (an identifier used to disconnect the multi- 
plexer, see I_UNLINK) on success, and a -1 on failure. 
On failure, errno is set to one of the following values: 

[ENXIO] Hangup received on fildes. 

[ETIME] Time out before acknowledgment 

message was received at stream head. 
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I.UNLINK 



[EAGAIN] 


Temporarily unable to allocate storage 
to perform the I_LINK. 


[ENOSR] 


Unable to allocate storage to perform 
the I_LINK due to insufficient 
STREAMS memory resources. 


[EBADF] 


arg is not a valid, open file descriptor. 


[EINVAL] 


fildes stream does not support multi- 
plexing. 


[EINVAL] 


arg is not a stream, or is already 
linked under a multiplexer. 


[EINVAL] 


The specified link operation would 
cause a "cycle" in the resulting config- 
uration; that is, if a given stream head 
is linked into a multiplexing configu- 
ration in more than one place. 



An I_LINK can also fail while waiting for the multi- 
plexing driver to acknowledge the link request, if a 
message indicating an error or a hangup is received at 
the stream head of fildes. In addition, an error code 
can be returned in the positive or negative ack- 
nowledgment message. For these cases, I_LINK will 
fail with errno set to the value in the message. 

Disconnects the two streams specified by fildes and 
arg. fildes is the file descriptor of the stream con- 
nected to the multiplexing driver, fildes must corre- 
spond to the stream on which the ioctl I_LINK com- 
mand was issued to link the stream below the multi- 
plexing driver, arg is the multiplexer ID number that 
was returned by the I_LINK. If arg is -1, then all 
Streams which were linked to fildes are disconnected. 
As in I_LINK, this command requires the multiplexing 
driver to acknowledge the unlink. On failure, errno is 
set to one of the following values: 

[ENXIO] Hangup received on fildes. 

[ETIME] Time out before acknowledgment 

message was received at stream head. 

[ENOSR] Unable to allocate storage to perform 
the LUNLINK due to insufficient 
STREAMS memory resources. 
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[EINVAL] arg is an invalid multiplexer ID num- 
ber or fildes is not the stream on which 
the I_LINK that returned arg was per- 
formed. 

An LUNLINK can also fail while waiting for the mul- 
tiplexing driver to acknowledge the link request, if a 
message indicating an error or a hangup is received at 
the stream head of fildes. In addition, an error code 
can be returned in the positive or negative ack- 
nowledgment message. For these cases, LUNLINK 
will fail with errno set to the value in the message. 



See Also 



close(S), fcntl(S), intro(S), ioctl(S), open(S), read(S), getmsg(S), 
poll(S), putmsg(S), signal(S), sigset(S), write(S) 

STREAMS Programmers Guide 
STREAMS Primer 



Diagnostics 



Unless specified otherwise above, the return value from ioctl is 0 upon 
success and -1 upon failure with errno set as indicated. 
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subsystem 

security subsystem component description 

Description 

Altos UNIX System V includes extensions to UNIX that segregate 
commands and data that are used to implement system services. 
Many of these commands have been grouped into subsystems. A 
group of commands and data performing similar security relevant 
tasks or together protecting a set of resources is termed a protected 
subsystem. 

The operating system has the following protected subsystems: 

• Memory 

• Terminal 

• Line Printer 

• Backup 

• Authentication 

• Cron 

• Audit 

The description of each subsystem includes the following information: 

Group and Subsystem Authorization Name 

Each subsystem is associated with a subsys- 
tem authorization. The commands and files 
associated with the subsystem take the sub- 
system authorization name as their group 
name. Users wishing to use the subsystem 
must have the appropriate subsystem author- 
ization. 

Commands Each subsystem has a set of commands. 

Helper Programs Some subsystems use helper programs. 

These are programs which call other pro- 
grams. 

Data Files A subsystem’s programs use permanent and 

temporary data files. 

The administrative functions associated with each subsystem can be 
selected from the sysadmsh menu. Help information is available with 
each option. 
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The mem subsystem authorization is defined to grant users the ability 
to use the memory subsystem commands to view total system activity. 
Users without this authorization may only view their own processes. 
Traditional UNIX allowed any user to view total system activity. This 
authorization was introduced to allow the administrator to isolate 
users, and restrict their ability to sense the activity of other users. 



Mem Authorization and Group Name 

In order to look at information in the mem subsystem, an administra- 
tor must have the mem authorization. The administrator responsible 
for maintaining users’ processes should be the only person with this 
authorization. This administrator may need to list users’ processes in 
order to select one or more of them for removal (using the kill(C) 
command). The following is a table of command modifications 
managed by the mem authorization: 



Command 


With Mem 


Without mem 


ps 


lists all processes 
(standard behavior) 


list processes owned 
by login user ID, or 
owned by real user ID 
of current process on 
current terminal 


whodo 


lists all processes 
(standard behavior) 


list processes on ter- 
minus owned by user 


ipcs 


lists all objects 
(standard behavior) 


list objects for which 
user is creator or 
owner or for which 
user has read access 



sysadmsh Selection 

The Memory subsystem does not have a sysadmsh selection as the 
Printer subsystem does. The Memory subsystem includes the system 
tables that contain information about memory and processes, which is 
accessed by several commonly-used Altos UNIX System V utilities. 



Commands 

ps An administrator with mem authorization can use the 

command to list all users’ processes. Using the 
command without the mem authorization shows only 
those processes associated with the user invoking it. 

whodo An administrator with mem authorization can use the 
whodo{kT>M) command to list processes by terminal. 
Someone using the command without mem 
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authorization sees only the processes associated with 
his/her terminal. 

ipcs An administrator with mem authorization can use this 
command to view active semaphores, shared memory 
segments and message queues (known collectively as 
IPC entities). Without mem authorization, a user is 
restricted to viewing IPC entities that they own or 
created and those which have read permission. Even 
entities that are writable, but not readable, cannot be 
displayed. 

crash An administrator with mem authorization can run the 
crash program to report information on kernel data 
structures. The report includes security information. 

An administrator can search for information by running crash and 
specifying an identifier name. 



Helper Programs 

timex Because timex uses internal kernel data structures, it 
must be run from an account in the mem group. 



Accounting Programs 

Accounting programs such as ^a(ADM), acctcom (ADM), and 
sar(ADM) also use information in the mem subsystem. These pro- 
grams must be run from an account in the mem group. 



Data Files 

All files through which programs may access kernel memory are pro- 
tected with owner root, group mem, and mode -r-r . As for all 

files, the root account bypasses the discretionary check on these files, 
and root programs may violate the System Architecture requirement. 
All root programs (those running with effective ID equal to root) must 
take care when running other programs, because those programs 
inherit the right to modify the running copy of the TCB. The following 
files are protected by the mem subsystem according to the above 
owner, group, and mode: 

The terminal subsystem protects the use of terminals by restricting 
the use of the write (C) and mesg (C) commands. 



Terminal Authorization and Group Name 
In order to send information from one terminal to another, the user 
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sending information must have the terminal authorization and the 
receiving terminal must be configured to accept information from 
other terminals. 

All terminals belong to the terminal group. Each terminal is owned 
by and can only be used by a given user identity. 



sysadmsh Selection 

The terminal subsystem does not control sysadmsh functions. 



Commands 

When an unauthorized user uses the write command, any special con- 
trol codes or escape sequences he sends are trapped and converted to 
presentable ASCII characters. All control codes are output as 



"<char> 

where <char> is the character whose ASCII code is the character sent 
plus 0100. For instance, ASCII NUL (0), SOH (1), and ACK (6) are 
output as (@ is 0100), "A (A is 0101) and "F, respectively, on the 
recipient’s terminal. The ASCII ESC (033) character writes as "[ and 
the DEL (0177) character writes as "?. 

As an example of using the trusted write command, assume there is a 
hypothetical terminal that silently stores any string between two 
ASCII DC4 (024) characters. This string is transmitted from the same 
hypothetical terminal to the computer when the terminal receives a 
DC2 (022) character. Assume that a devious user knows the recipient 
of a write command has this terminal and tries to corrupt the 
recipient’s session by sending a damaging message. If this user did 
not have the terminal authorization, the recipient would see the 
message: 



How are y"Trm *"Tou today'E? 

The recipient would be alerted to an attempt on his session. In addi- 
tion, the terminal subsystem audits this event so you can locate 
suspect activity. On the other hand, if the sending user has the termi- 
nal authorization, the recipient would see the message: 



How are you today? 



The following commands are modified to support the terminal subsys- 
tem. 
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Command 


With Terminal 


Without Terminal 


write 


unrestricted 
(standard behavior) 


control codes output as "<chai> 


mesg 


changes sense of 
group write permis- 
sion only 


same 



A person with terminal authorization can use the write (C) command 
to write to another terminal and send control codes and escape 
sequences. A malicious user might use the command to send mali- 
cious commands and breach system security. 

Without the authorization, a user can use the write (C) command, but 
control codes and escape sequences are displayed on the receiving ter- 
minal in their ASCII form, thus warning the recipient of suspicious 
activity. Such activity is recorded by the audit facilities. 

The mesg y form of the command allows messages, but sets write per- 
mission for the terminal device group that has been set to terminal by 
the login program. The new write command is SGID to terminal, 
which allows it to send characters to user terminals that have used 
mesg y. of the file enough for the terminal group to write to the termi- 
nal. The new write command handles this change. Unlike the less 
trusted mesg, Altos UNIX System V mesg never allows any permission 
to all users. 



Data Files 

The data files for the terminal subsystem are the terminals themselves. 
They belong to the terminal group at the start and end of each ses- 
sion, and all access is denied except to the user. The preferred way for 
a user to open and close access to a terminal is to use the mesg com- 
mand. When a session is not in progress on a terminal, only the super 
user can access the device file. Some terminal files are presented 
below. 

/dev/console This is the system console. Use of this terminal as 
a user terminal is discouraged because: 

• Messages from the kernel appear on 
/dev/console. To avoid losing these 
messages or intermixing them with user 
messages, it is better to use the console 
solely for the message output. 

• On some systems, physical access to the 
console is equivalent to having access to 
the entire system. Use another terminal 
unless the system configuration prevents 
this. In any event, allow physical access to 
/dev/console only to the most trusted users 
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of the system. 

/dev/tty* Most of the terminals on the system are named 
/dev/ttyl , /dev/tty2 , /dev/tty3 , ... These devices 
may at times be owned by a protected subsystem 
(such as UUCP or terminal) and be unavailable for 
general use. You have the option of configuring 
the terminals for login sessions, protected subsys- 
tems, or for nothing. 

Line Printer Subsystem 



The purpose of the Ip subsystem is to provide an administrative role 
that has control over printing facilities. Unlike the less trusted version 
of the Ip commands, the trusted version does not require a special 
printer account that owns and executes (with the SUID bit set) all the 
printer programs. Instead, there is an Ip group with multiple users as 
its members. 



Authorization/Group Name 

The Ip authorization allows the user to be a printer administrator. 
This allows multiple Printer administrators. They force the adminis- 
trator to have a login userid (LUID) of 0 or a login name of Ip , a 
scheme that does not allow you much flexibility in account setups or 
individual accountability. 

All printer administrators are allowed to execute some commands that 
non-authorized users cannot, and can perform certain actions within 
commands that are restricted from other users. Only administrators 
may run accept, Ipadmin, Ipmove, Ipsched, Ipshut, reject and topq. 
For the other commands, enhancements due to Ip authorization are 
detailed under each command heading. 



sysadmsh Selection 

The Ip authorization allows access to the printing functions under the 
System-^Printer selection as described in the “Using Printers” 
chapter. 



Commands 

To determine the invoker, the Printer subsystem command uses the 
immutable login user ID (LUID). Less trusted versions use various 
other schemes, all of which could be fooled. The commands listed 
here perform exactly like their traditional (less trusted) versions 
except where noted: 
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accept The accept command may only be used by printer 
administrators. 

cancel The less trusted version of cancel allowed any user to 
cancel any job. The originating user is notified of the 
cancellation via mail. The trusted version of cancel 
gives this right to printer administrators only. Mail is 
still sent to the originator when a job is canceled by the 
printer administrator. Other users can only remove jobs 
they submitted, 

disable The disable command operates without change from 
the less trusted version. 

enable The enable command operates without change from the 
less trusted version. 

Ip The trusted version of the Ip command, with the -w 

option enabled by you, never writes to the terminal 
directly as does the less trusted version of Ip. The 
trusted version of Ip knows that the system prohibits 
direct writing to another user’s terminal. Instead, the 
write (C) program is used to send the message; refer to 
the previous discussion of write in the terminal subsys- 
tem. 

The trusted version of the Ip command creates an out- 
put label for each file submitted. The output label con- 
tains the system label (the same as seen on most termi- 
nals), the owner, group, and mode of the file. To accu- 
rately determine the output label, the Ip command can- 
not accept input from pipes. This is because the discre- 
tionary attributes of a file are not available if the file 
was accessed on the other end of a pipe. Note that 
input redirection and temporary files may still be 
printed. 

Printer files are always copied to the printer spool by 
assuming the -c (copy) option, even if the user did not 
explicitly request it. By doing this, the Ip subsystem 
ensures that the file cannot be altered between the time 
the request was made and the time it is printed. (The 
less trusted version of Ip does not guarantee that the file 
cannot be updated, even while the printer is running.) 
As added protection, the file being copied is locked 
during the formation of the output label and the copy 
operation, so that the file and label output accurately 
reflects the file being printed. 

Ipadmin The Ipadmin command may only be used by printer 
administrators. 
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Ipforms The Ipforms command operates without change from 
the less trusted version. 

Ipmove The Ipmove command may only be used by printer 
administrators. 

Ipsched The Ipsched command may only be used by printer 
administrators. When the Ipsched command uses a 
printer device dedicated to the Ip subsystem, the sub- 
system guarantees exclusive use of the printer device 
each time it is used. Any prior activity (outside the Ip 
subsystem) on that device is forcibly stopped. In this 
way, the Ip subsystem ensures that the file being output 
is not interspersed with other output, unlike less trusted 
versions. 

Ipshut The Ipshut command may only be used by printer 
administrators. 

Ipstat The trusted version of Ipstat does not display other 
users’ jobs if the invoking user does not have the Ip 
authorization. Knowing the jobs of other users is not 
necessary since unauthorized users cannot hold or can- 
cel those jobs anyway, printer administrators see all 
printer jobs, and they can hold or cancel any job that 
has been submitted. 

reject The reject command may be used only by printer 
administrators. 

topq The topq command may be used only by printer 
administrators. 



Data Files 

/usr/spool/lp All the files in this file hierarchy have the same 
formats and purposes as their counterparts in less 
trusted versions of UNIX. In the trusted version, 
the files are accessible by any printer administra- 
tor, so that the group permissions are the only ones 
of true importance. In all cases, the spool, its 
directories, and all data files allow no access to the 
user population. Hence, a user can be assured that 
a private file that is spooled for printing cannot be 
accessed or changed by untrusted users. 

Backup Subsystem 



The purpose of the backup subsystem is to provide a full set of disk 
and tape management tools without requiring detailed knowledge of 
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Altos UNIX System V. The backup administrator assumes responsibil- 
ity of file system maintenance. The backup administrator is responsi- 
ble for all actions which do not modify the format of file systems, 
while the root account is still responsible for formatting, configuring, 
and maintaining the consistency of file system disk partitions. 



Authorization/Group Name 

The user with backup authorization, a Backup administrator, may per- 
form file backups. Restorations can only be made by the root user. 
The following authorizations are defined for the backup subsystem: 



Authorization Type Purpose I 


backup 

queryspace 


primary 

secondary 


enables system backup command 
allows use of d/* program 



All disk partitions are protected with owner root, group backup and 
mode -r— r — .. The mount table (/etc/mnttab) is publicly readable, 
modified only by the mount command. The df program is SGID to 
backup, enforcing the queryspace and backup authorizations. 



sysadmsh Selection 

The backup authorization allows access to the backup functions under 
the Backups selection. 



Commands 

df The df command may only be used by Backup 

administrators. Otherwise, the options and output 
format remain the same as the less trusted version. 

mkfs The mkfs command may only be used by a 

member of the backup group (or by the super-user, 
which is discouraged). As always, this command 
must be used to initialize a filesystem after the 
partitions are laid out. Immediately after mkfs is 
run, you should run labelit to complete the initiali- 
zation. 

labelit The labelit program, documented in 

volcopy{PiDM), associates the filesystem with a 
directory mount point. 



Helper Programs 

letcimount This program is used by backupif to display 

and modify the mounted file systems. 
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letcifsck This program is used by backup to check and 

repair filesystems. 

lusri bin! backup This program is used to copy entire UNIX and 

XENIX filesystems to either magtape or car- 
tridge tape. 



lusri bin! xbackup This program is used to copy entire XENIX 
disk filesystems to either magtape or cartridge 
tape. 

lusri bin! xrestore This program is used by replace entire XENIX 
filesystem images on magtape or cartridge tape 
to a clean (newly formatted with mkfs ) 



lusri bin! restore This program is used by replace entire XENIX 
or UNIX filesystem images on magtape or car- 
tridge tape. 



lusribinicpio This is the default backup program, cpio 
makes non-filesystem specific copies of 
filesystem data. 



Data Files 

/etc/default/ filesys 

This file contains the relationship between mounted 
filesystem devices and the directories on which they 
are mounted (mount points). It is used to display that 
relationship in both df and the backup selection. 
Because altering this file would display erroneous 
information to backup administrators and reading 
this file defaults the access protection created for the 
backup subsystem, this file must be accessible to the 
backup group only. 

/dev/[r]d[s]k* 

These block and character special files are the 
buffered interfaces to the disk partitions you have set 
up. They are used for mounting the filesystem they 
contain onto a directory. The backup group must be 
able to read and write these files. It is a severe secu- 
rity breach if others can access these files in ary 
way. 

Authentication Subsystem 



The Authentication subsystem provides you with an exhaustive set of 
account management services. These services are: 
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• self-checking to prevent dangerous actions, and 

• monitored extensively by the auditing system. 



Authorization/Group Name 

The auth authorization allows an Authentication administrator to per- 
form sensitive actions on the Authentication database. This database 
contains all information on account ownership, types, authorizations, 
locked status, login times, password change times, and various other 
parameters. 

With the auth authorization, an Authentication administrator may 
alter Authentication parameters for other users. Because this database 
directly controls the attributes of any account on the system, this sub- 
system controls user access to your system. The trust you place in the 
system can be no greater than that placed in the Authentication 
administrators. Not only must they be trustworthy people, but they 
must also not leave any uncorrected mistakes when assigning authori- 
zations to the accounts they manage. 



sysadmsh Selection 

The auth authorization allows access to the user account management 
functions under Accounts. 



Commands 

passwd The passwd command in Altos UNIX System V has 
been greatly enhanced for both security and flexibility. 
The trusted system checks on system-wide password 
parameters as well as user-specific ones and, depending 
on the results found, the user has a choice of choosing 
their own password or having one chosen for them. 
You can set each account to do either one of these, or 
do both. A closely related change is that, regardless of 
the method for getting the password, you can have the 
system screen passwords that are probable guesses by 
intruders. The password selection method, as well as 
the optional restriction screening, are set by Authenti- 
cation administrators in sysadmsh for a single account 
or for system- wide use. 

login The login command is no longer available as a com- 
mand used in a session to start a new session. Instead, 
a user must first log out before logging in as another 
user. 
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Sublogins are forbidden since the LUID of a session may not change 
once it is set. This is to guarantee to you that the owner of a session is 
known at all times. If the login program were allowed to be run from 
a session, the login USERID would have to change and the guarantee 
would be broken. 

The login program is still invoked from getty to start a user session. 
The procedure for logging in is almost the same. The user supplies a 
login name and the system requests a password. Once the password is 
entered, the system either lets the user log in or rejects the login 
attempt. A user may be rejected for a number of reasons: 

1 . The account does not exist. 

2. The password was entered incorrectly. 

3. The password lifetime has been passed. 

4. The number of unsuccessful attempts made to the account has 
surpassed a system or account threshold. 

5. The number of unsuccessful attempts made to the terminal has 
surpassed a system or terminal threshold. 

6. An Authentication administrator has unconditionally locked 
the account. 

Reasons 3 throughh 6 notify the user that the Authentication adminis- 
trator has locked the account. 

If the user enters the correct login name/password combination, the 
last successful and unsuccessful login times are displayed on the ter- 
minal. The user should view the dates and times of each to determine 
if someone else has used the account. These dates may also be used to 
determine whether a Trojan horse program is simulating the login pro- 
cedure to obtain a password. A user with doubts about the authenticity 
of the login dates and times should report it to you. The earlier you 
take action on this, the better you can use fresh audit trails and 
people’s recollections to find the source of the problem. 

su The su program has been strengthened a great deal for 

security. It now uses information from the Authentication 
database in determining whether or not to allow a user to 
“switch” to another user. The following rules apply: 

• A user cannot use su to enter an account that has 
been locked. 

• The su command cannot be used as a means to 
bypass the lock-checking done by login, at, and 
cron. 
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newgrp The newgrp command operates without change from the 
less trusted version. 

auths The auths command is especially tailored for Altos UNIX 
System V to allow all users to adjust their authorizations. 
No user can increase authorizations, but one can tem- 
porarily decrease authorizations in order to run an 
un trusted program or to prevent mistakes. More details on 
the authorizations and syntax are given in the man page for 
auths (C). 



Data Files 

/usr/adm/sulog 

This file keeps track of the history of use of the su program. 
Each line represents an attempt to run the su program. The 
date and time are first recorded on the line. Then, a 
means the attempt failed; a ‘+’ means the attempt suc- 
ceeded. After the or code, the terminal of the 
attempt is provided. Last, the login name (using the login 
UID) of the invoker of su , together with the login name of 
the (attempted) changed real UID is presented. As an 
example, the following log excerpt presents some interest- 
ing situations: 



su 


02/29 


19:19 


+ 


tty?? 


' root -Ip 


su 


03/01 


20:22 


+ 


tty2 


blf-root 


su 


03/04 


04:13 


+ 


tty2 


fred-pro jl 


su 


03/07 


20:30 


- 


tty2 


reese-star 


su 


03/07 


20:30 


+ 


tty2 


reese-star 


su 


03/07 


21:38 


+ 


modem auth-root 


su 


03/07 


21:39 


+ 


tty2 


blf-root 


su 


03/07 


21:39 


- 


tty7 


daa-root 


su 


03/07 


21:40 


- 


tty7 


daa-root 


su 


03/07 


21:40 


- 


tty7 


daa-root 


su 


03/07 


21:41 


- 


tty7 


daa-root 


su 


03/07 


21:41 


- 


tty7 


daa-root 


su 


03/07 


21:47 


+ 


tty2 


fred-pro jl 



• Foremost, it appears as though the user daa is 
attempting to break into the root account, for there 
are many unsuccessful attempts (denoted with the 

attribute) in rapid succession. That should be 
investigated further. 

• The su program does not require one to become the 
root user. In the log above, users root , fred and 
reese chose to assume the identities of other users. 
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• In the effort by reese to become the star user, the 
first attempt failed and the next immediately suc- 
ceeded. This occurs frequently and is quite natural 
when users mistype the password of the other 
account. You should get suspicious, however, when 
the number of unsuccessful attempts becomes large. 
Such attempts, like the case with daa above, prob- 
ably means a breach of security. 

• The su program was used by root to enter the Ip 
account. This occurrence was detached from any 
terminal, because of the special terminal designa- 
tion of tty??. This particular case occurred from 
letcirc where the Ipsched daemon is run. 

The lusrIadmJsulog file needs attention periodically. It should be 
examined and then pruned, saving the most recent entries. The entries 
removed from the file should be archived if possible rather than com- 
pletely deleted. 

/tcb/files/auth 

This directory consists of subdirectories that contain 
private account data for all the accounts in the system. 
There is a file for each account. Because of the sensitive 
nature of the data here, all these files are completely 
protected from the users. 

/etc/auth/system 

This directory contains the system-wide authorization 
data for the machine. The ! etc! auth! system directory 
contains the Terminal Control database, the File Control 
database, the Command Control database and the Sys- 
tem Defaults database. This information is accessible to 
the users but not writable. The I etclauthi subsystems 
directory contains one file per protected subsystem, each 
containing the user permissions for that protected sub- 
system. This permissions file may only be read by the 
programs that are part of that protected subsystem, and 
is written by the auth user. 



cron Subsystem 



The purpose of the cron subsystem is to allow cron^ at, and batch ser- 
vices that are audited as closely as normal login sessions. The cron 
subsystem provides a useful interface for controlling these facilities. 



Authorization/Group Name 

The authorization for the cron subsystem is given to cron administra- 
tors that are allowed to view or alter the authority for users to run the 
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services associated with the cron subsystem. A user may run the pro- 
grams of the cron subsystem (excluding the use of the sysadmsh selec- 
tions) without the authorization, so long as a cron administrator has 
granted the authority. 



sysadmsh Selection 

The cron authorization allows access to the process management 
functions under Jobs . 



Commands 

at, batch, crontab 

These at commands operate without change from 
the less trusted version, except that the LUID 
(login UID), rather than the real UID, is used by at 
in determining the user. Because the LUID cannot 
be altered during a session, it promotes better 
accountability, at and batch jobs run with all of 
the login, real, and effective UIDs set to that of the 
login user. 



Helper Programs 

Itcbilibicron This is the cron daemon that actually runs all at, 
batch, and crontab jobs. The at, batch, and cron- 
tab commands merely queue the jobs for the cron 
daemon to run. This daemon validates the account 
(ensures the account is not locked) before running 
the job. 



Data Files 



Although enumerated here, these data files are not manipulated 
directly by the cron administrator because of the arcane rules histori- 
cally applied to them by the cron subsystem programs. Instead, the 
sysadmsh provides a more coherent interface, reducing the possibility 
that users or permissions are set up incorrectly. 



/usr/lib/cron This is the directory containing all the 

cron administrative files. 



/usr/lib/cron/at.allow This file lists the users allowed to exe- 
cute the at or batch programs. If this 
file exists, it is used to determine the 
user’s authority. 

/usr/lib/cron/at.deny This file lists the users denied access 
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to the at or batch programs. If 
/usr/lib/cron/at.allow does not exist, 
lusrilibi cron! at. deny is used to deter- 
mine the user’s authority. You should 
be aware that an empty at.deny file 
permits access for all users. 

/usr/lib/cron/cron.allow This file lists the users allowed to exe- 
cute the crontab program. If this file 
exists, it is used to determine the 
user’s authority. 

/usr/lib/cron/cron.deny This file lists the users denied access 
to the crontab program. If 
lusrilibi cron! cron.allow does not 

exist, lusrilibi cron! cron. deny is used 
to determine the user’s authority. You 
should be aware that an empty 
cron.deny file permits access for all 
users. 

/usr/lib/cron/.proto This file contains a list of commands 
that are executed before every at job. 
It contains commands primarily used 
to fix and restrict the environment of 
the user before running the job sub- 
mitted. 

/usr/lib/cron/.proto.b This file contains a list of commands 
that are executed before every batch 
job. It contains commands primarily 
used to fix and restrict the environ- 
ment of the user before running the 
job submitted. 

/usr/lib/cron/log This is a log of all at, batch, and cron- 

tab activity reported by the cron 
daemon since the system was 
rebooted. It provides an accurate 
ASCII log of all user initiated non- 
terminal activity. If the system is up 
for a very long time and there are 
many job submissions or crontab 
activity, this file should be 
periodically examined, pruned, and 
archived. 

/usr/lib/cron/OLDlog This is the log associated with the last 
time the system was up. Upon startup, 
the cron daemon moves any 
/usr/lib/cron/log file here. 
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/usr/spool/cron This is the root of the subtree where 

all at, crontab, and batch jobs are 
stored, at and batch jobs are 
automatically cleared when they have 
finished executing. The -r option of 
crontab removes a crontab job. 

Audit Subsystem 



The purpose of the audit subsystem is to provide an administrative 
role that has control over auditing facilities. 



Authorization/Group Name 

The audit authorization allows the user to be the audit administrator. 
The audit adminsitrator can enable and disable auditing, examine 
audit records, generate reports and alter audit parameters. 



sysadmsh Selection 

The audit authorization allows access to the audit functions under the 
System -^Audit selection as described in the “Maintaining System 
Security” chapter. 



Commands 

auditcmd The command interface for audit subsystem activation, 
termination, statistic retrievel, and subsystem 
notification. 

auditd The auditd utility is the daemon that runs when audit- 
ing is enabled. 

reduce This program performs audit data analysis and rduc- 
tion. 



Data Files 

/tcb/ files/audit/audit_parms 

Audit parameters file. 

/tcb/files/audit/* 

Audit log file directory. 

/tcb/audittmp Audit compaction file directory. 
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auditcmd(ADM), auditd(ADM), authck(ADM), integrity(ADM), 
reduce(ADM), chg_audit(ADM), auths(C), authcap(F), audit(HW) 
“Maintaining System Security” in the System Administrator's Guide 

Value Added 



subsystem is an extension of AT&T System V provided in Altos UNIX 
System V. 
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sxt 

pseudo-device driver 

Description 



sxt is a pseudo-device driver that interposes a discipline between the 
standard tty line disciplines and a real device driver. The standard dis- 
ciplines manipulate virtual tty structures (channels) declared by the 
sxt driver, sxt acts as a discipline manipulating a real tty structure 
declared by a real device driver. The sxt driver is currently only used 
by the shl{C) command. 

Virtual ttys are named /dev/sxt??? and are allocated in groups of up 
to eight. To allocate a group, a program should exclusively open a file 
with a name of the form /dev/sxt??0 (channel 0) and then execute a 
SXTIOCLINK ioctl call to initiate the multiplexing. 

Only one channel, the controlling channel, can receive input from the 
keyboard at a time; others attempting to read will be blocked. 

There are two groups of ioctl (S) commands supported by sxt. The 
first group contains the standard ioctl commands described in 
termio(M), with the addition of the following: 

TIOCEXCL Set exclusive use mode: no further opens are permit- 
ted until the file has been closed. 

TIOCNXCL Reset exclusive use mode: further opens are once 
again permitted. 

The second group are directives to sxt itself. Some of these may only 
be executed on channel 0. 

SXTIOCLINK Allocate a channel group and multiplex the 
virtual ttys onto the real tty. The argument is 
the number of channels to allocate. This com- 
mand may only be executed on channel 0. 
Possible errors include: 

EINVAL The argument is out of range. 

ENOTTY The command was not issued from a 
real tty. 

ENXIO linesw is not configured with sxt. 
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EBUSY An SXTIOCLINK command has 
already been issued for this real tty. 

ENOMEM 

There is no system memory avail- 
able for allocating the virtual tty 
structures. 

EBADF Channel 0 was not opened before 
this call. 

SXTIOCSWTCH Set the controlling channel. Possible errors 
include: 

EINVAL An invalid channel number was 
given. 

EPERM The command was not executed 
from channel 0. 

SXTIOCWF Cause a channel to wait until it is the control- 

ling channel. This command will return the 
error, EINVAL, if an invalid channel number is 
given. 

SXTIOCUBLK Turn off the loblk control flag in the virtual tty 
of the indicated channel. The error EINVAL 
will be returned if an invalid number or chan- 
nel 0 is given. 

SXTIOCSTAT Get the status (blocked on input or output) of 
each channel and store in the sxtblock structure 
referenced by the argument. The error 
EFAULT will be returned if the structure can- 
not be written. 

SXTIOCTRACE Enable tracing. Tracing information is written 
to the console. This command has no effect if 
tracing is not configured. 

SXTIOCNOTRACE Disable tracing. This command has no effect if 
tracing is not configured. 

Files 

/dev/sxt??[0-7] virtual tty devices 

/usr/include/sys/sxt.h driver specific definitions 
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shl(C), stty(C), ioctl(S), open(S), termio(M) 



SXT(M) 
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systty 

system maintenance device 

Description 



The file /dev/systty is the device on which system error messages are 
displayed. The actual physical device accessed via /dev/systty is 
selected during boot, and is typically the device used to control the 
bootup procedure. The default physical device /dev/systty is deter- 
mined by when the system is brought up. 

Initially /dev/console is linked to /dev/systty. 

Files 



/dev/systty 

See Also 



boot(HW), console(M) 



March 15, 1989 



SYSTTY-1 







TERM (M) 



TERM (M) 



term 

conventional names for terminals 
Description 



These names are used by certain commands [e.g., man(C), tabs(C), 
tput(C), v/(C) and curses(S)] and are maintained as part of the shell 
environment in the environment variable TERM [see sh(C)y 
profile (F), and environ(M)]. 

Entries in terminfo(F) source files consist of a number of comma- 
separated fields. [To obtain the source description for a terminal, use 
the -I option of inf ocmp (ADM).] White space after each comma is 
ignored. The first line of each terminal description in the terminfo (F) 
data base gives the names by which terminfo (F) knows the terminal, 
separated by bar ( I ) characters. The first name given is the most com- 
mon abbreviation for the terminal [this is the one to use to set the 
environment variable TERMINFO in $HOME/. profile', see profile(F)], 
the last name given should be a long name fully identifying the termi- 
nal, and all others are understood as synonyms for the terminal name. 
All names but the last should contain no blanks and must be unique in 
the first 14 characters; the last name may contain blanks for readabil- 
ity. 

Terminal names (except for the last, verbose entry) should be chosen 
using the following conventions. The particular piece of hardware 
making up the terminal should have a root name chosen. For example, 
for the AT&T 4425 terminal, the root name is att4425. This name 
should not contain hyphens, except that synonyms may be chosen that 
do not conflict with other names. Up to 8 characters, chosen from 
[a-zO-9], make up a basic terminal name. Names should generally be 
based on original vendors, rather than local distributors. A terminal 
acquired from one vendor should not have more than one distinct 
basic name. Terminal sub-models, operational modes that the hard- 
ware can be in, or user preferences, should be indicated by appending 
a hyphen and an indicator of the mode. Thus, an AT&T 4425 terminal 
in 132 column mode would be att4425-w. The following suffixes 
should be used where possible: 



Suffix 


Meaning 


Example 


-w 


Wide mode (more than 80 columns) 


att4425-w 


-am 


With auto, margins (usually default) 


vtlOO-am 


-nam 


Without automatic margins 


vtlOO-nam 


-n 


Number of lines on the screen 


aaa-60 
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-na No arrow keys (leave them in local) clOO-na 

-np Number of pages of memory cl00-4p 

-r V Reverse video alt44 1 5 -rv 

To avoid conflicts with the naming conventions used in describing the 
different modes of a terminal (e.g., -w), it is recommended that a 
terminal’s root name not contain hyphens. Further, it is good practice 
to make all terminal names used in the terminfo{¥) data base unique. 
Terminal entries that are present only for inclusion in other entries via 
the use= facilities should have a in their name, as in 4415+nl. 



Some of the known terminal names may include the following (for a 
complete list, type: Is -C /usr/lib/terminfo/?): 



2621,hp2621 

2631 

2631 -c 

2631-e 

2640,hp2640 

2645,hp2645 

3270 

33,tty33 

35,tty35 

37,tty37 

4000a 

4014,tek4014 

40,tty40 

43,tly43 

4410,5410 

4410-nfk,5410-nflc 

4410-nsl,5410-nsl 

4410-w,5410-w 

4410vl,5410vl 

4410vl-w,5410vl-w 

4415,5420 

4415-nl,5420-nl 

4415-rv,5420-rv 

4415-rv-nl,5420-rv-nl 

4415-w,5420-w 

4415 -w-nl,5420- w-nl 

44 1 5 -w-rv,5420- w-rv 
4415 - w-rv-nl,5420- w-rv-nl 

4418,5418 

4418-w,5418-w 

4420 

4424 

4424- 2 
4425,5425 

4425- fk,5425-fk 
4425-nl,5425-nl 

4425-w,5425-w 

4425-w-fk,5425-w-fk 

4425-nl-w,5425-nl-w 

4426 



Hewlett-Packard 2621 series 

Hewlett-Packard 2631 line printer 

Hewlett-Packard 2631 line printer - compressed mode 

Hewlett-Packard 2631 line printer - expanded mode 

Hewlett-Packard 2640 series 

Hewlett-Packard 2645 series 

IBM Model 3270 

AT&T TELETYPE Model 33 KSR 
AT&T TELETYPE Model 35 KSR 
AT&T TELETYPE Model 37 KSR 
Trendata 4000a 
TEKTRONIX 4014 
AT&T TELETYPE Dataspeed 40/2 
AT&T TELETYPE Model 43 KSR 
AT&T 4410/5410 terminal in 80-column mode - version 2 
AT&T 4410/5410 without function keys - version 1 
AT&T 4410/5410 without pin defined 
AT&T 4410/5410 in 132-column mode 
AT&T 4410/5410 terminal in 80-column mode - version 1 
AT&T 4410/5410 terminal in 132-column mode - version 1 
AT&T 4415/5420 in 80-column mode 
AT&T 4415/5420 without changing labels 
AT&T 4415/5420 80 columns in reverse video 
AT&T 4415/5420 reverse video without changing labels 
AT&T 4415/5420 in 132-column mode 
AT&T 4415/5420 in 132-column mode without changing 
labels 

AT&T 4415/5420 132 columns in reverse video 
AT&T 44 15/5420 132 columns reverse video 
without changing labels 
AT&T 5418 in 80-column mode 
AT&T 5418 in 132-column mode 
AT&T TELETYPE Model 4420 
AT&T TELETYPE Model 4424 

AT&T TELETYPE Model 4424 in display function group ii 
AT&T 4425/5425 

AT&T 4425/5425 without function keys 
AT&T 4425/5425 without changing labels in 80-column 
mode 

AT&T 4425/5425 in 132-column mode 
AT&T 4425/5425 without function keys in 132-column 
mode 

AT&T 4425/5425 without changing labels in 132-column 
mode 

AT&T TELETYPE Model 4426S 
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450 

450-12 

500,att500 

510,510a 

513bct,att513 

5320 

5420_2 

5420_2-w 

5620,dmd 

5620-24,dmd-24 

5620-34, dmd-34 

610,610bct 

610-w,610bct-w 

7300,pc7300,unix_pc 

735,ti 

745 

dumb 

hp 

IP 

pt505 

pt505-24 

sync 



DASI 450 (same as Diablo 1620) 

DASI 450 in 12-pitch mode 
AT&T-IS 500 terminal 
AT&T 5 10/5 10a in 80-column mode 
AT&T 513 bet terminal 
AT&T 5320 hardcopy terminal 
AT&T 5420 model 2 in 80-column mode 
AT&T 5420 model 2 in 132-column mode 
AT&T 5620 terminal 88 columns 
AT&T TELETYPE Model DMD 5620 in a 24x80 layer 
AT&T TELETYPE Model DMD 5620 in a 34x80 layer 
AT&T 610 bet terminal in 80-column mode 
AT&T 610 bet terminal in 132-column mode 
AT&T UNIX PC Model 7300 
Texas Instruments TI735 and TI725 
Texas Instruments TI745 
generic name for terminals that lack reverse 
line-feed and other special escape sequences 
Hewlett-Packard (same as 2645) 
generic name for a line printer 
AT&T Personal Terminal 505 (22 lines) 

AT&T Personal Terminal 505 (24-line mode) 
generic name for synchronous TELETYPE Model 
4540-compatible terminals 



Commands whose behavior depends on the type of terminal should 
accept arguments of the form -Tterm where term is one of the names 
given above; if no such argument is present, such commands should 
obtain the terminal type from the environment variable TERM , 
which, in turn, should contain term . 



Files 



/usr/lib/terminfo/? compiled terminal description data base 

See Also 



curses(S), profile(F), terminfo(M), terminfo(F), environ(M), 
infocmp(ADM), sh(C), stty(C), tabs(C), tput(C), tplot(ADM), vi(C) 

Notes 

Not all programs follow the above naming conventions. 
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terminals 

list of supported terminals 
Description 



The following list, derived from the file /etc/termcap, shows the ter- 
minal name (suitable for use as a TERM shell variable), and a short 
description of the terminal. The advice in termcap(F) will assist users 
in creating termcap entries for terminals not currently supported. 



Name 


Terminal 


1200 


terminet 1200 


1620 


diablo 1620 


1640 


diablo 1640 


2392 


239x series 


2392an 


hp 23 9x in ansi mode 


2392ne 


239x series 


2621 


hp 2621 


2621k45 


hp 2621 with 45 keyboard 


2621nl 


hp 2621 with no labels 


2621nt 


hp 2621 w/no tabs 


2621wl 


hp 2621 with labels 


2622 


hp 2622 


262x 


hp 262x series 


2640 


hp 2640a 


2640b 


hp 264x series 


300 


terminet 300 


3045 


datamedia 3045a 


33 


model 33 teletype 


37 


model 37 teletype 


40 


teletype dataspeed 40/2 


4025 


tektronix 4024/4025/4027 


4025-17 


tek 4025 17 line window 


4025- 17ws 


tek 4025 17 line window in workspace 


4025ex 


tek 4025 w/! 


43 


model 43 teletype 


515 


AT&T-IS 515 terminal in native mode 


5410 


5410 terminal 80 columns 


5410-nfk 


version 1 tty5410 entry without function keys 


5410132 


5410 132 columns 


5420132 


5420 132columns 


5425 


AT&T Teletype 5425 80 columns 


5425-w 


AT&T Teletype 5425 132 columns 
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610bct 
615mt 
620mtg 
7900 
8001 
912b 
925 
925so 
ATT5620 
Ma2 
TWO 
a980 
aa 
aaa 
aaa30 
aaa48db 
aaadb 
act5s 
adds 
adds25 
adml 1 
adml2 
adm2 
adm3 
adm31 
adm3a 
adm3a+ 
adm3al9.2 
adm3aso 
adm42 
adm5 
aj830 
altos3 
altos4 
altos5 
am219w 
amp219 
amp232 
ampex 
ansi 

ansi-nam 

arpanet 

at386 

at386-m 

atarist 

att513 

att513-w 
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AT&T 610; 80 column; 98key keyboard 

AT&T 615; 80 column; 98key keyboard 

AT&T 620; 80 column; 98key keyboard 

NCR 7900-1 

intecolor 

new televideo 

newer tele video 

newer televideo with attribute byte workaround 

5620 terminal 88 columns 

Ampex Model 232 / 132 lines 

Altos Computer Systems II 

adds consul 980 

ann arbor 

ann arbor ambassador/48 lines 

ann arbor ambassador 30/destructive backspace 

ann arbor ambassador 48/destructive backspace 

ann arbor ambassador 48/destructive backspace 

skinny act5 

adds viewpoint 

adds regent 25 with local printing 

Isiadmll 

Isi adml 2 

Isi adm2 

Isi adm3 

Lear Siegler ADM31 
Isi adm3a 
Isi adm3a-i- 

Isi adm3a at 19.2 baud 
Isi adm3a with { ) for standout 
Isi adm42 
Isi adm5 

anderson Jacobson 
Altos III 
Altos IV 
Altos V 

Ampex 132 Cols 
Ampex with Automargins 
Ampex Model 232 
ampex dialogue 80 
Ansi standard crt 

Ansi standard crt without automargin 

network 

at/386 console 

at/386 console 

Atari ST vt52 

AT&T-IS 513 Business Communications Terminal 80 
columns 

AT&T-IS 513 Business Communications Terminal 132 
columns 
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att605 


AT&T 605 BCT 


att630 


AT&T 630 windowing terminal 


bctSOO 


teletype 5541 


bh3m 


beehivelllm 


big2621 


48 line 2621 


clOO 


concept 100 


cl004p 


cl 00 w/4 pages 


clOOrv 


cl 00 rev video 


cl00rv4p 


cl 00 w/4 pages 


cl00rv4pna 


cl 00 with no arrows 


cl00rv4ppp 


cl 00 with printer port 


clOOrvs 


slow reverse concept 100 


clOOs 


slow concept 100 


c3102 


cromemco 3102 


carlock 


klc 


cci 


cci 4574 


cdc456 


cdc 


cdc456tst 


cdc456tst 


cdi 


cdi 1203 


cie467 


C.Itoh 467, 414 Graphics 


citSO 


c.itoh 80 


citSOnam 


C.Itoh 80 without automargins 


compucolor 


compucolorll 


dl32 


datagraphix 132a 


datapoint 


datapoint 3360 


delta 


delta data 5000 


dg 


data general 6053 


digilog 


digilog 333 


dml520 


datamedia 1520 


dml521 


datamedia 1521 


dm2500 


datamedia 2500 


dm3025 


datamedia 3025a 


dmterm 


Tandy deskmate terminal 


dosansi 


ANSI.SYS standard crt 


dtlOO 


Tandy DT-100 terminal 


dtlOOw 


Tandy DT- 1 00 terminal 


dt200 


Tandy DT-200 


dtSO 


datamedia dt80/l 


dt80132 


datamedia dt80/l in 132 char mode 


dtc300s 


dtc 300s 


du 


dialup 


dumb 


unknown 


dwl 


decwriter 1 


dw2 


decwriter II 


ep40 


execuport 4000 


ep48 


execuport 4080 


esp925 


esprit tvi925 emulation 


espHA 


esprit 6310 in hazeltine emulation mode 
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ethemet 


network 


exidy 


exidy sorcerer as dm2500 


fos 


Fortune system 


fox 


perkin elmer 1 100 


free 100 


liberty freedom 100 


freel 10 


Freedom 110 


ftl024 


Forward Technology graphics controller 


gt40 


dec gt40 


gt42 


dec gt42 


hl500 


hazeltine 1500 


hl510 


hazeltine 1510 


hl520 


hazeltine 1520 


hl552 


hazeltine 1552 


hl552rv 


hazeltine 1552 reverse video 


hl9 


heathkit hl9 w/ function keypad 


hl9a 


heathkit hi 9 ansi mode 


hl9nk 


heathkit w/numeric keypad (not function keys) 


h2000 


hazeltine 2000 


hp 


hp 264x series 


hp2626 


hp 2626 


hp2648 


HP 2648a graphics terminal 


hpansi 


Hewlett Packard 700/44 in HP-PCterm mode, PC char- 
acter set 


hpansi-24 


HP 700/44 in HP-PCterm 24 line mode, PC character set 


hpex 


hp extended capabilites 


hpsub 


hp terminals - capability subset 


ilOO 


General Terminal lOOA (formerly Infoton 100) 


ibmBlOl 


IBM 3101-10 


ibm3151 


3151 


ibm3161 


3161 


ibm3163 


3163 


ibm3164 


3164 


ibm5151 


ibm console 


ibmcons 


Ansi standard with EGA 


ibmcons-43 


Ansi EGA console in 43 line mode 


intext 


ISC modified owl 1200 


ipc 


Intel IPC 


klO 


Kaypro 10 


kn 


kt70pcix 


kt7ix 


kimtron kt-7 


lisa 


apple lisa xenix console display (white on black) 


mlOO 


radio shack model 1(X) 


macterm 


macintosh MacTerm in vt-100 mode 


macterm-nam 


MacTerm in vt-100 mode with automargin NOT set 


mdlllO 


cybemex mdl-110 


microb 


micro bee series 


microterm 


microterm act iv 


microtermS 


microterm act v 
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mime 

mime2a 

mime2as 

mime3a 

mime3ax 

mimefb 

mimehb 

mt70 

nabu 

netx 

nucterm 

oadm31 

omron 

ot80 

owl 

pe550 

pixel 

plasma 

ptl500 

pt210 

qume5 

qvtlOl 

qvtl01+ 

qvtlOl+so 

qvtlOlb 

qvtl02 

qvtl03 

qvtlOS 

qvtl09 

qvtll9 

qvtll9+ 

qvt201 

qvt202 

qvt203 

regent 

regentlOO 

regent20 

regent25 

regent25a 

regent40 

regentbO 

regentbOna 

rx303 

sbl 

sb2 

sexidy 

sk8620 

soroc 
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microterm mimel 

microterm mime2a (emulating an enhanced vt52) 

microterm mime2a (emulating an enhanced soroc iql20) 

mimel emulating 3a 

mimel emulating enhanced 3a 

full bright mimel 

half bright mimel 

morrow mt70 

nabu terminal 

netronics 

NUC homebrew 

oldadm31 

Omron 8025AG 

onyx ot80 

perkin elmer 1200 

perkin elmer 550 

Pixel terminal 

plasma panel 

Convergent Technologies PT 

Tandy TRS-80 PT-210 printing terminal 

Qume Sprint 5 

Qume QVT-101 vers c 

Qume QVT-101 Plus vers c 

Qume QVT-101+ with protected mode/standout 

QVT-101 with cursor set to blinking underline 

Qume QVT 102 

Qume QVT-103 

QVT-108 

QVT-109 

QumeQVT-119 

Qume QVT-1 19 Plus vers c 

Qume QVT-201 

Qume QVT-202 

Qume QVT 203 PLUS 

adds regent series 

adds regent 100 

adds regent 20 

adds regent 25 

adds regent 25a 

adds regent 40 

adds Regent 60 

regent 60 w/no arrow keys 

rexon 303 terminal 

beehive super bee 

fixed superbee 

exidy smart 

Seiko 8620 

Soroc 120 
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sun 


Sun Microsystems Workstation console 


sun-cmd 


Sun Microsystems Workstation console with scrollable 
history 


sun-nic 


Sun Microsystems Workstation console without insert 
character 


sunl 


old Sun Microsystems Workstation console 


superbeeic 


super bee with insert char 


svtlOO 


1220/PC, Sperry in VTIOO mode 


svtl210 


Sperry 1210, standard setup 


svtl220 


Sperry 1220, standard setup 


svt52 


1210/1220/PC, Sperry in VT52 mode 


switch 


intelligent switch 


swtp 


southwest technical products ct82 


tl061 


teleray 1061 


tl061f 


teleray 1061 with fast PROMs 


t3700 


dumb teleray 3700 


t3800 


teleray 3800 series 


td200 


Tandy 200 


tek 


tektronix 4012 


tek4013 


tektronix 4013 


tek4014 


tektronix 4014 


tek4014sm 


tektronix 4014 in small font 


tek4015 


tektronix 4015 


tek4015sm 


tektronix 4015 in small font 


tek4023 


tektronix 4023 


tek4107 


tektronix 4107 


teletec 


Teletec Datascreen 


terak 


Terak emulating Datamedia 1520 


ti 


ti silent 700 


ti745 


ti silent 745 


ti924 


Texas Instruments 924 VDT 7 bit 


ti924-8 


Texas Instruments 924 VDT 8 bit 


ti926 


Texas Instruments 926 VDT 


ti931 


Texas Instruments 931 VDT 


trslOO 


Tandy TRS-80 Model 100 


trsl6 


Tandy trs-80 model 16 console 


trs600 


Tandy Model 600 


tty4420 


teletype 4420 


tty4424 


teletype 4424 


tty4424-w 


teletype 4424 in display function group ii 


tty5410 


Teletype 5410 terminal in 80 column mode 


tty 54 10- w 


Teletype 5410 in 132 column mode 


tvi910 


old televideo 910 


tvi910+ 


televideo 910 PLUS 


tvi912 


old televideo 


tvi9220 


Televideo 9220 w/status line @ bottom 


tvi9220w 


Televideo 9220 132 col w/status line @ bottom 


tvi924 


televideo924 
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tvi950 


televideo950 


tvi950-2p 


tvi 950 w/2 pages 


tvi950-4p 


tvi 950 w/4 pages 


tvi950-ap 


tvi 950 w/alt pages 


tvi950b 


bare tvi950 no is 


tvi950ns 


tvi950 w/no standout 


v50 


Visual 50 emulation of DEC VT52 


v55 


Visual 55 emulation of DEC VT52 (called V55) 


vi200 


visual 200 with function keys 


vi200f 


visual 200 no function keys 


vi200ic 


visual 200 using insert char 


vi200rv 


visual 200 reverse video 


vi200rvic 


visual 200 reverse video using insert char 


vi50 


Visual 50 in ADDS viewpoint emulation 


vi55 


Visual 55 using ADDS emulation 


vis613 


Visual 613 


vslOO 


xterm terminal emulator 


vslOOs 


xterm terminal emulator (small screen 24x80) 


vtlOO 


dec VtlOO 


vtlOOn 


VtlOO w/no ink 


vtlOOnam 


DEC VTIOO without automargins 


vtlOOs 


dec VtlOO 132 cols 14 lines 


vtlOOw 


dec VtlOO 132 cols 


vtl02 


dec vtl02 


vtl31 


dec vtl31 


vtl32 


vM32 


vt220 


dec vt220 generic 


vt220d 


DEC VT220 in vtlOO mode with DEC function key 
labeling 


vt50 


dec vt50 


vtSOh 


dec vt50h 


vt52 


dec vt52 


vt52so 


dec vt52 with brackets added for standout use 


vtz 


Zilog vtz 2/10 


W2110A 


Wang 2110 Asynch Data Entry Terminal - 80 column 


ws584 


Olivetti WS584 


ws584fr 


Olivetti WS584 with French keyboard 


ws584gr 


Olivetti WS584 with German keyboard 


ws584nr 


Olivetti WS584 with Norwegian/Danish keyboard 


ws584sp 


Olivetti WS584 with Spanish keyboard 


ws584sw 


Olivetti WS584 with Swedish/Finnish keyboard 


ws584uk 


Olivetti WS584 with U.K. keyboard 


ws584us 


Olivetti WS584 with U.S.A. keyboard 


ws685 


Olivetti WS685 


wylOO 


wyse 100 


wyl20 


Wyse 120 


wy 120-25 


Wyse 120 80-column 25-lines 


wyl20-vb 


Wyse 120 Visible bell 
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wyl20-wvb 

wyl20w 

wyl20w-25 

wyl50 

wy 150-25 

wyl50-vb 

wyl50-wvb 

wyl50w 

wyl50w-25 

wy30 

wy30-vb 

wy350 

wy350-vb 

wy350-wvb 

wy350w 

wy50 

wy50-wvb 

wy501 

wy50n 

wy50vb 

wy50w 

wy60 

wy60-25 

wy60-42 

wy60-43 

wy60-vb 

wy60ak 

wy60w 

wy60w-25 

wy60w-42 

wy60w-43 

wy60w-vb 

wy75 

wy75-mc 

wy75-vb 

wy75-wvb 

wy75ap 

wy75w 

wy75x 

wy85 

wy85-vb 

wy85-wvb 



wysel20-wvb 
Wyse 120 132-column 
Wyse 120 132-column 25-lines 
Wyse 150 

Wyse 150 80-column 25-lines 

Wyse 150 Visible bell 

wysel50-wvb 

Wyse 150 132-column 

Wyse 150 132-column 25-lines 

Wyse WY-30 in wy30 mode 

wyse 30 Visible bell 

Wyse 350 80 column color terminal emulating wy50 

wyse 350 Visible bell 

wyse 350 132-column Visible bell 

Wyse 350 132 column color terminal emulating wy50 

Wyse 50/80 Wyse WY-50 with 80 column screen 

wyse 50 132-column Visible bell 

Wyse WY-60 with 80 column/43 line screen in WY50+ 

mode 

Wyse WY-50 - 80 column screen, no automargin 
Wyse WY-50/80vb Wyse WY-50/80 with visible bell 
Wyse WY-50/132 Wyse WY-50 with 132 column 
screen 

Wyse WY-60 with 80 column/24 line screen in wy60 
mode 

wyse 60 80-column 25-lines 
wyse 60 80-column 42-lines 
wyse 60 80-column 43-lines 
Wyse 60 Visible bell 

Wyse 60 in wy60 mode with ANSI arrow keys + 

Wyse WY-60 with 132 column/24 line screen in wy60 
mode 

wyse 60 132-column 25-lines 

wyse 60 132-column 42-lines 

wyse 60 132-column 43-lines 

Wyse 60 132-column Visible bell 

Wyse WY-75 with 80 column line 

wyse 75 with magic cookies 

wyse 75 with visible bell 

wyse 75 with visible bell 132 columns 

Wyse WY-75 with Applications and Cursor keypad 

modes 

Wyse WY-75 in 132 column mode 

Wyse WY-75 with 132 column lines in vi editor mode 

Wyse 85 in 80 column mode, vtlOO emulation 

wyse 85 with visible bell 

wyse 85 with visible bell 132-columns 
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wy85w 


Wyse 85 in 132 column mode, vtlOO emulation 


wy85w 


wyse 85 in 132-column mode 


wy99gt 


Wyse 99gt 


wy99gt-25 


wyse 99gt 80-column 25-lines 


wy99gt-25-w 


wyse 99gt 132-column 25-lines 


wy99gt-vb 


Wyse 99gt Visible bell 


wy99gt-w 


wyse 99gt 132-column 


wy99gt-w-vb 


wyse99gt-wvb 


wysel20ak 


Wyse 12^0 with ANSI key values 


xl720 


xerox 1720 


xitex 


xitex set- 100 


z29 


zenith z29 


z39 


Zenith Z-39 


zen30 


zentec 30 


zen40 


zentec 40 


zen50 


zentec 50 


zephyr 


zentec zephyr220 in vtlOO mode 


zephymam 


zentec zephyr220 in vtlOO mode w/out automargins 



Files 

/etc/termcap 

See Also 

tset(C), environ(M), termcap(F) 
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terminfo 

terminal capability data base 

Syntax 

/usr/lib/terminfo/? /* 

Description 



terminfo is a compiled database [see tic{C)\ describing the capabilities 
of terminals. Terminals are described in terminfo source descriptions 
by giving a set of capabilities which they have, by describing how 
operations are performed, by describing padding requirements, and by 
specifying initialization sequences. This database is used, for exam- 
ple, by vi{C) and cursesiS), so they can work with a variety of termi- 
nals without changes to the programs. To obtain the source descrip- 
tion for a terminal, use the -I option of infocmp {PiDM). When doing 
an infocmp for the terminal you are on, there is no difference between 
infocmp and infocmp -/. 

Entries in terminfo source files consist of a number of fields separated 
by commas. White space after each comma is ignored. The first line 
of each terminal description in the terminfo database gives the name 
by which terminfo knows the terminal, separated by bar ( I ) charac- 
ters. The first name given is the most common abbreviation for the 
terminal [this is the one to use to set the environment variable TERM 
in $HOMEI. profile', see profile(F)]', the last name given should be a 
long name fully identifying the terminal, and all others are understood 
as synonyms for the terminal name. All names but the last should 
contain no blanks and must be unique in the first 14 characters; the 
last name may contain blanks for readability. 

Terminal names (except for the last verbose entry) should be chosen 
using the following conventions. The particular piece of hardware 
making up the terminal should have a root name chosen, for example, 
for the AT&T 4425 terminal, att4425. Modes that the hardware can 
be in, or user preferences, should be indicated by appending a hyphen 
and an indicator of the mode. See term(M) for examples and more in- 
formation on choosing names and synonyms. 



PART 1: TERMINAL CAPABILITIES 

Capabilities in terminfo are of three types: boolean capabilities 
(which show that the terminal has some particular feature), numeric 
capabilities (which specify the size of the terminal or particular fea- 
tures), and string capabilities (which provide a sequence that can be 
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used to perform particular terminal operations). 

In the following tables, a Variable is the name by which a C program- 
mer accesses a capability (at the terminfo level). A Capname is the 
short name for a capability used in the source description. It is used 
by a person updating the database and by the tput(C) command when 
asking what the value of the capability is for a particular terminal. A 
Termcap Code is a two-letter code that corresponds to the old 
termcap capability name. 

Capability names have no hard length limit, but an informal limit of 
five characters has been adopted to keep them short. Whenever possi- 
ble, names are chosen to be the same as or similar to those specified 
by the ANSI X3.64-1979 standard. Semantics are also intended to 
match those of the ANSI standard. 

All string capabilities listed below may have padding specified, with 
the exception of those used for input. Input capabilities, listed under 
the Strings section in the following table, have names beginning with 
key_. The following indicators may appear at the end of the Descrip - 
tion for a variable. 

(G) 

indicates that the string is passed through tparm( ) with parameters 
(parms) as given (#p 

(*) 

indicates that padding may be based on the number of lines 
affected 

th 

indicates the i parameter 
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Booleans 



Variable 


Cap- 

name 


Termcap 

Code 


auto_left_margin 


bw 


bw 


auto_right_margin 


am 


am 


back_color_erase 


bee 


be 


can_change 


ccc 


cc 


ceol_standout_glitch 


xhp 


xs 


col_addr_glitch 


xhpa 


YA 


cpi_changes_res 


cpix 


YF 


cr_cancels_micro_mode 


crxm 


YB 


eat_newline_glitch 


xenl 


xn 


erase_overstrike 


eo 


eo 


generic_type 


gn 


gn 


hard_copy 


he 


he 


hard_cursor 


chts 


HC 


has_metajkey 


km 


km 


has_print_wheel 


daisy 


YC 


has_status_line 


hs 


hs 


hue_lightness_saturation 


his 


hi 


insert_null_glitch 


in 


in 


lpi_changes_res 


Ipix 


YG 


memory_above 


da 


da 


memory_below 


db 


db 


move_msert_mode 


mir 


mi 


move_standout_mode 


msgr 


ms 


needs_xon_xoff 


nxon 


nx 


no_esc_ctlc 


xsb 


xb 


no_pad_char 


npc 


NP 


non_dest_scroll_region 


ndscr 


ND 


non_rev_rmcup 


nrrmc 


NR 


over_strike 


os 


os 


prtr_silent 


mc5i 




row_addr_glitch 


xvpa 


YD 


semi_auto_right_margin 


sam 


YE 


status_line_esc_ok 


eslok 


es 


dest_tabs_magic_smso 


xt 


xt 


tilde_glitch 


hz 


hz 


transparent_underline 


ul 


ul 


xon_xoff 


xon 


xo 



Description 

cubl wraps from column 0 to last column 
Terminal has automatic margins 
Screen erased with background color 
Terminal can re-define existing color 
Standout not erased by overwriting (hp) 

Only positive motion for hpa/mhpa caps 
Changing character pitch changes resolution 
Using cr turns off micro mode 
Newline ignored after 80 columns {Concept) 

Can erase overstrikes with a blank 
Generic line type (e.g., dialup, switch) 

Hardcopy terminal 

Cursor is hard to see 

Has a meta key (shift, sets parity bit) 

Printer needs operator to change character set 
Has extra "status line" 

Terminal uses only HLS color notation (Tektronix) 
Insert mode distinguishes nulls 
Changing line pitch changes resolution 
Display may be retained above the screen 
Display may be retained below the screen 
Safe to move while in insert mode 
Safe to move in standout modes 
Padding won’t work, xon/xoff required 
Beehive (fl=escape, f2=ctrl C) 

Pad character doesn’t exist 
ScroUing region is non-destructive 
smcup does not reverse rmcup 
Terminal overstrikes on hard-copy terminal 

Only positive motion for vpa/mvpa caps 
Printing in last column causes cr 
Escape can be used on the status line 
Destructive tabs, magic smso char (tl061) 
Hazeltine; can’t print tilde (~) 

Underline character overstrikes 
Terminal uses xon/xoff handshaking 
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Numbers 

Variable 

buffer_capacity 

columns 

dot_vert_spacing 

dot_horz_spacmg 

init_tabs 

label_height 

label_width 

lines 

lines_of_memory 

magic_cookie_glitch 

max_attributes 

max_colors 

max_micro_address 

max_micro_jump 

maxjpairs 

maximum_windows 

micro_col_size 

micro_line_size 

no_color_video 

number_of_pins 

num_labels 

output_res_char 

output_res_line 

output_res_horz_inch 

output_res_vert_inch 

paddin g , baud rate 

print_rate 

virtual_terminal 

wide_char_size 

width_status_line 
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Cap- 

name 


Termcap 

Code 


Description 


bufsz 


Ya 


Number of bytes buffered before printing 


cols 


CO 


NumbCT of columns in a line 


spinv 


Yb 


Spacing of pins VCTtically in pins per inch 


spinh 


Yc 


Spacing of dots horizontally in dots per inch 


it 


it 


Tabs initially every # spaces 


Ih 


Ih 


Number of rows in each label 


Iw 


Iw 


Number of columns in each label 


lines 


U 


Number of lines on a screen or a page 


Im 


Im 


Lines of memory if > lines; 0 means varies 


xmc 


sg 


Number of blank characters left by smso or rmso 


ma 


ma Maximum combined video attributes terminal can display 


colors 


Co 


Maximum number of colors on the screen 


maddr 


Yd 


Maximum value in micro_..._address 


mjump 


Ye 


Maximum value in parm__..._niicro 


pairs 


pa 


Maximum number of color-pairs on the screen 


wnum 


MW 


Maximum number of definable windows 


mcs 


Yf 


Character step size when in micro mode 


mis 


Yg 


Line step size when in micro mode 


ncv 


NC 


Video attributes that can’t be used with colors 


npins 


Yh 


Number of pins in print-head 


nlab 


N1 


Number of labels on screen (start at 1) 


ore 


Yi 


Horizontal resolution in units per character 


orl 


Yj 


Vertical resolution in units per line 


orhi 


Yk 


Horizontal resolution in units per inch 


orvi 


Yl 


Vertical resolution in units p>er inch 


pb 


pb 


Lowest baud rate where padding needed 


cps 


Ym 


Print rate in characters per second 


vt 


vt 


Virtual terminal number (UNIX system) 


widcs 


Yn 


Character step size when in double wide mode 


wsl 


ws 


Number of columns in status line 
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Strings 



Variable 


Cap- 

name 


Teimcap 

Code 


acs_chars 


aese 


ac 


back_tab 


cbt 


bt 


bell 


bel 


bl 


carriagc_rctum 


cr 


cr 


changc_char_pitch 


cpi 


ZA 


change_line_pitch 


Ipi 


ZB 


change_res_horz 


chr 


ZC 


changc_res_vert 


cvr 


ZD 


change_scroll_region 


csr 


cs 


char_padding 


rmp 


rP 


char_set_names 


esnm 


Zy 


clear_all_tabs 


tbc 


ct 


clcar_margins 


mge 


MC 


clear_scrcen 


clear 


cl 


clr_bol 


ell 


cb 


clr_eol 


el 


ce 


clr_eos 


ed 


cd 


column_address 


hpa 


ch 


command_charactcr 


emdeh 


CC 


create_window 


ewin 


CW 


cursor_address 


cup 


cm 


cursor_down 


cudl 


do 


cursor_home 


home 


ho 


cursor_invisible 


civis 


vi 


cursorjeft 


cubl 


le 


cursor_mem_address 


mrcup 


CM 


cursor_normal 


cnorm 


ve 


cursor_right 


cufl 


nd 


cursor_to_ll 


11 


11 


cursor_up 


cuul 


up 


cursor_visible 


cvvis 


vs 


define_char 


defc 


ZE 


delete_character 


dchl 


dc 


delete_line 


dll 


dl 


delete_phone 


dial 


DI 


dis_status_line 


dsl 


ds 


display_clock 


dclk 


DK 


down_half_line 


hd 


hd 


ena_acs 


enacs 


eA 


enter_alt_charset_mode 


smacs 


as 


enter_am_mode 


smam 


SA 


enter_blink_mode 


blink 


mb 


enter_bold_mode 


bold 


md 


enter_ca_mode 


smeup 


ti 


enter_delete_mode 


smdc 


dm 



Description 

Graphic charset pairs aAbBcC - def=vtl00 
Back tab 

Audible signal (bell) 

Carriage return (*) 

Change number of characters per inch (dg 
Change number of lines per inch (dg 
Change horizontal resolution (dg 
Change vertical resolution (dg 
Change to lines #1 through #2 (vtKX)) (G) 

Like ip but when in replace mode 
List of character set names 
Clear all tab stops 

Clear all margins (top, bottom, and sides) 

Clear screen and home cursor (+) 

Clear to beginning of line, inclusive 
Clear to end of line 
Clear to end of display (♦) 

Horizontal position absolute (G) 

Terminal settable cmd character in prototype 
Define win #1 to go from #2,#3 to #4,#5 
Move to row #1 col #2 (G) 

Down one line 
Home cursor (if no cup) 

Make cursor invisible 
Move left one space. 

Memory relative cursor addressing (G) 

Make cursor appear normal (undo vs/vi) 
Non-destructive space (cursor or carriage fight) 
Last line, first column (if no cup) 

Upline (cursor up) 

Make cursor very visible 

Define a character in a character set t 

Delete character (*) 

Delete line (*) 

Dial phone number #1 
Disable status line 
Display time-of-day clock 
Half-line down (forward 1/2 linefeed) 

Enable alternate character set 

Start alternate character set 

Turn on automatic margins 

Turn on blinking 

Turn on bold (extra bright) mode 

String to begin programs that use cup 

Delete mode (enter) 
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Strings (cont.) 

Variable 



enter_dim_mode 

enter_doublewide_mode 

enter_draft_quality 

enter_insert_mode 

enter_ital ics_mode 

enter_leftward_mode 

enter_micro_mode 

enter_near_letter_quality 

enter_normal_quality 

enter_protected_mode 

enter_reverse_mode 

enter_secure_mode 

enter_shadow_mode 

enter_standout_mode 

enter_subscript_mode 

enter_superscript_mode 

enter_underline_mode 

enter_upward_mode 

enter_xon_mode 

erase_chars 

exit_alt_charset_mode 

exit_am_mode 

exit_attribute_mode 

exit_ca_mode 

exit_delete_mode 

exit_doublewide_mode 

exit_insert_mode 

exit_italics_mode 

exit_leftward_mode 

exit_micro_mode 

exit_shadow_mode 

exit_standout_mode 

exit_subscript_mode 

exi t_superscr ipt_mode 

exit_underline_mode 

exit_upward_mode 

exit_xon_mode 

fixed_pause 

flash_hook 

flash_screen 

form_feed 

from_status_line 

goto_window 

hangup 
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Cap- 

name 


Termcap 

Code 


Description 


dim 


mh 


Turn on half-bright mode 


swidm 


ZF 


Enable double wide printing 


sdrfq 


ZG 


Set draft quality print 


smir 


im 


InsCTt mode (enter) 


sitm 


ZH 


Enable italics 


slm 


ZI 


Enable leftward carriage motion 


smicm 


ZJ 


Enable micro motion capabilities 


snlq 


ZK 


Set near-letter quality print 


snrmq 


ZL 


Set normal quality print 


prot 


mp 


Turn on protected mode 


rev 


mr 


Turn on reverse video mode 


invis 


mk 


Turn on blank mode (characters invisible) 


sshm 


ZM 


Enable shadow printing 


smso 


so 


Begin standout mode 


ssubm 


ZN 


Enable subscript printing 


ssupm 


zo 


Enable superscript printing 


smul 


US 


Start underscore mode 


sum 


ZP 


Enable upward carriage motion 


smxon 


sx 


Turn on xon/xoff handshaking 


ech 


ec 


Erase #1 characters (G) 


rmacs 


ae 


End alternate character set 


rmam 


RA 


Turn off automatic margins 


sgrO 


me 


Turn off all attributes 


rmcup 


te 


String to end programs that use cup 


rmdc 


ed 


End delete mode 


rwidm 


ZQ 


Disable double wide printing 


rmir 


ei 


End insert mode 


ritm 


ZR 


Disable italics 


rim 


ZS 


Enable rightward (normal) carriage motion 


imicm 


ZT 


Disable micro motion capabilities 


rshm 


zu 


Disable shadow printing 


imso 


se 


End standout mode 


rsubm 


zv 


Disable subscript printing 


rsupm 


zw 


Disable superscript printing 


rmul 


ue 


End underscore mode 


rum 


zx 


Enable downward (normal) carriage motion 


rmxon 


RX 


Turn off xon/xoff handshaking 


pause 


PA 


Pause for 2-3 seconds 


hook 


fh 


Flash the switch hook 


flash 


vb 


Visible bell (may not move cursor) 


ff 


ff 


Hardcopy terminal page eject (*) 


fsl 


fs 


Return from status line 


wingo 


WG 


Got to window #1 


hup 


HU 


Hang-up phone 
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Strings (com.) 



Variable 


Cap- 

name 


Termcap 

Code 


init_l string 


isl 


il 


init_2string 


is2 


is 


init_3string 


is3 


i3 


init_file 


if 


if 


init_prog 


iprog 


iP 


initialize_color 


initc 


Ic 


initialize_pair 


initp 


Ip 


msert_character 


ichl 


ic 


insert_line 


U1 


al 


insert_padding 


ip 


ip 


key_al 


kal 


K1 


key_a3 


ka3 


K3 


key_b2 


kb2 


K2 


key_backspace 


kbs 


kb 


key_beg 


kbeg 


@1 


key_btab 


kcbt 


kB 


key_cl 


kcl 


K4 


key_c3 


kc3 


K5 


key_cancel 


kcan 


@2 


key_catab 


ktbc 


ka 


key_clear 


kdr 


kC 


key_close 


kclo 


@3 


key_command 


kcmd 


@4 


key_copy 


kcpy 


@5 


key_create 


kcrt 


@6 


key_ctab 


kctab 


kt 


key_dc 


kdchl 


kD 


key_dl 


kdll 


kL 


key_down 


kcudl 


kd 


key_eic 


krmir 


kM 


key_end 


kend 


@7 


key_enter 


kent 


@8 


key_eol 


kel 


kE 


key_eos 


ked 


kS 


key_exit 


kext 


@9 


key_f0 


kfO 


kO 


key_fl 


kfl 


kl 


key_f2 


kf2 


k2 


key_B 


kf3 


k3 


key_f4 


kf4 


k4 


key_f5 


kf5 


k5 


key_f6 


kf6 


k6 


key_f7 


kn 


k7 


key_f8 


kf8 


k8 



Description 



Terminal or printer initialization string 

Terminal or printer initialization string 

Terminal or printer initialization string 

Name of initialization file 

Path name of program for initialization 

Initialize the definition of color 

Initialize color-pair 

Insert character 

Add new blank line (♦) 

Insert pad after character inserted (*) 

KEY_A1, 0534, upper left of keypad 
KEY_A3, 0535, upper right of keypad 
KEY_B2, 0536, center of keypad 
KEY_B ACKSPACE, 0407, sent by backspace key 
KEY_BEG, 0542, sent by beg(inning) key 
KEY_BTAB, 0541, sent by back-tab key 
KEY_C1, 0537, lower left of keypad 
KEY_C3, 0540, lower right of keypad 
KEY_CANCEL, 0543, sent by cancel key 
KEY_CATAB, 0526, sent by clear-all-tabs key 
KEY_CLEAR, 0515, sent by dear-screen or erase key 
KEY.CLOSE, 0544, sent by close key 
KEY_COMMAND, 0545, sent by cmd (command) key 
KEY.COPY, 0546, sent by copy key 
KEY_CREATE, 0547, sent by create key 
KEY_CTAB, 0525, sent by dear-tab key 
K£Y_DC, 0512, sent by delete-character key 
KEY_DL, 0510, sent by delete-line key 
KEY_DOWN, 0402, sent by terminal down-arrow key 
KEY_EIC, 0514, sent by rmir or smir in insert mode 
KEY_END. 0550, sent by end key 
KEY_ENTER, 0527, sent by enter/send key 
KEY_EOL, 0517, sent by dear-to-end-of-line key 
KEY_EOS, 0516, sent by clear-to-end-of-screen key 
KEY.EXrr, 0551, sent by exit key 
KEY_F(0), 0410, sent by function key fO 
KEY_F(C), 0411, sent by function key fl 
KEY_F(S), 0412, sent by function key f2 
KEY_F(S), 0413, sent by function key D 
KEY_F(F), 0414, sent by function key f4 
KEY_F(M), 0415, sent by function key f5 
KEY_F(6), 0416, sent by function key f6 
KEY_F(7), 0417, sent by function key f7 
KEY_F(8), 0420, sent by function key f8 
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Strings (cont.) 



Variable 


Cap- 

name 


Termcap 

Code 


Description 


key_f9 


kf9 


k9 


KEY_F(9), 0421, sent by function key f9 


key_fl0 


kflO 


k; 


KEY_F(ADM), 0422, sent by function key flO 


key_f 1 1 


kfll 


FI 


KEY_F(ADM), 0423, sent by function key fll 


key_fl2 


kfl2 


F2 


KEY_F(ADM), 0424, sent by function key fl2 


key_fl3 


kfl3 


F3 


KEY_F(ADM), 0425, sent by function key fl3 


key_fl4 


kfl4 


F4 


KEY_F(ADM), 0426, sent by function key fl4 


key_fl5 


kfl5 


F5 


KEY_F(ADM), 0427, sent by function key fl5 


key_fl6 


kH6 


F6 


KEY_F(ADM), 0430, sent by function key fl6 


key_fl7 


kfl7 


F7 


KEY_F(ADM), 0431, sent by function key fl7 


key_fl8 


kfl8 


F8 


KEY_F(ADM), 0432, sent by function key fl8 


key_fl9 


kH9 


F9 


KEY_F(ADM), 0433, sent by function key fl9 


key_f20 


kf20 


FA 


KEY_F(20), 0434, sent by function key f20 


key_f21 


k£21 


FB 


KEY_F(21), 0435, sent by function key f21 


key_f22 


kf22 


FC 


KEY_F(22), 0436, sent by function key f22 


key_f23 


kf23 


FD 


KEY_F(23), 0437, sent by function key f23 


key_f24 


kf24 


FE 


KEY_F(24), 0440, sent by function key f24 


key_f25 


kf25 


FF 


KEY_F(25), 0441, sent by function key f25 


key_f26 


kf26 


FG 


KEY_F(26), 0442, sent by function key f26 


key_f27 


kf27 


FH 


KEY_F(27), 0443, sent by function key f27 


key_f28 


kf28 


n 


KEY_F(28), 0444, sent by function key f28 


key_f29 


kf29 


FJ 


KEY_F(29), 0445, sent by function key f29 


key_f30 


kf30 


FK 


KEY_F(S), 0446, sent by function key BO 


key_f31 


kf31 


FL 


KEY_F(S), 0447, sent by function key B1 


key_B2 


kB2 


FM 


KEY_F(S), 0450, sent by function key B2 


key_f33 


kB3 


FN 


KEY_F(ADM), 0451, sent by function key fl3 


key_f34 


kB4 


FO 


KEY_F(S), 0452, sent by function key B4 


key_f35 


kB5 


FP 


KEY_F(S), 0453, sent by function key B5 


key_f36 


kB6 


FQ 


KEY_F(S), 0454, sent by function key B6 


key_f37 


kB7 


FR 


KEY_F(S), 0455, sent by function key B7 


key_f38 


kB8 


FS 


KEY_F(S), 0456, sent by function key B8 


key_f39 


kB9 


FT 


KEY_F(S), 0457, sent by function key B9 


key_f40 


kf40 


FU 


KEY_F(40), 0460, sent by function key f40 


key_f41 


kf41 


FV 


KEY_F(41), 0461, sent by function key f41 


key_f42 


kf42 


FW 


KEY_F(42), 0462, sent by function key f42 


key_f43 


kf43 


FX 


KEY_F(43), 0463, sent by function key f43 


key_f44 


kf44 


FY 


KEY_F(44), 0464, sent by function key f44 


key_f45 


kf45 


FZ 


K£Y_F(45), 0465, sent by function key f45 


key_f46 


kf46 


Fa 


KEY_F(46), 0466, sent by function key f46 


key_f47 


kf47 


Fb 


KEY_F(47), 0467, sent by function key f47 


key_f48 


kf48 


Fc 


KEY_F(48), 0470, sent by function key f48 


key_f49 


kf49 


Fd 


KEY_F(49), 0471, sent by function key f49 


key_f50 


kf50 


Fe 


KEY_F(50), 0472, sent by function key f50 


key_f51 


kf51 


Ff 


KEY_F(51), 0473, sent by function key f51 
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Strings (cont.) 



Variable 


Cap- 

name 


Termcap 

Code 


Description 


key_f52 


kf52 


Fg 


KEY_F(52), 0474, sent by function key f52 


key_f53 


kf53 


Fh 


KEY_F(53), 0475, sent by function key f53 


key_f54 


kf54 


Fi 


KEY_F(54), 0476, sent by function key f54 


key_f55 


kf55 


Fj 


KEY_F(55), 0477, sent by function key f55 


key_f56 


kf56 


Fk 


KEY_F(56), 0500, sent by function key f56 


key_f57 


kf57 


F1 


KEY_F(57), 0501, sent by function key f57 


key_f58 


kf58 


Fm 


KEY_F(58), 0502, sent by function key f58 


key_f59 


kf59 


Fn 


KEY_F(59), 0503, sent by function key f59 


key_f60 


kf60 


Fo 


KEY_F(60), 0504, sent by function key f60 


key_f61 


kf61 


Fp 


KEY_F(61), 0505, sent by function key f61 


key_f62 


kf62 


Fq 


KEY_F(62), 0506, sent by function key f62 


key_f63 


kf63 


Fr 


KEY_F(63), 0507, sent by function key f63 


key_find 


kfnd 


@0 


KEY_FIND, 0552, sent by find key 


key_hclp 


khlp 


%1 


KEY_HELP, 0553, sent by help key 


key_home 


khome 


kh 


KEY_HOME, 0406, sent by home key 


key_ic 


kichl 


kl 


KEY_IC, 0513, sent by ins-char/enter ins-mode key 


key_il 


kill 


kA 


KEY_IL, 0511, sent by insert-line key 


key_left 


kcubl 


kl 


KEY_LEFT, 0404, sent by terminal left-arrow key 


key_ll 


kll 


kH 


KEY_LL, 0533, sent by home-down key 


key_mark 


kmrk 


%2 


KEY_MARK, 0554, sent by mark key 


key_message 


kmsg 


%3 


KEY_MESS AGE, 0555, sent by message key 


key_move 


kmov 


%4 


KEY_MOVE, 0556, sent by move key 


key_next 


knxt 


%5 


KEY_NEXT, 0557, sent by next key 


key_npage 


knp 


kN 


KEY_NPAGE, 0522, sent by next-page key 


key_open 


kopn 


%6 


KEY_OPEN, 0560, sent by open key 


key_options 


kopt 


%7 


KEY_OPTIONS, 0561, sent by options key 


key_ppage 


kpp 


kP 


KEY_PPAGE, 0523, sent by previous-page key 


key_previous 


kprv 


%8 


KEY_PREVIOUS, 0562, sent by pervious-object key 


key_print 


kprt 


%9 


KEY_PRINT, 0532, sent by print or copy key 


key_redo 


krdo 


0 


KEY_REDO, 0563, sent by redo key 


key_reference 


kref 


&1 


KEY.REFERENCE, 0564, sent by ref(erence) key 


key_refresh 


krfr 


&2 


KEY_REFRESH, 0565, sent by refresh key 


key_replace 


krpi 


&3 


KEY_REPLACE, 0566, sent by replace key 


key_restart 


krst 


&4 


KEY_RESTART, 0567, sent by restart key 


key_resume 


kres 


&5 


KEY_RESUME, 0570, sent by resume key 


key_right 


kcufl 


kr 


KEY_RIGHT, 0405, sent by terminal right-arrow key 


key_save 


ksav 


&6 


KEY_SAVE, 0571, sent by save key 


key_sbeg 


kBEG 


&9 


KEY_SBEG, 0572, sent by shifted beginning key 


key_scancel 


kCAN 


&0 


KEY_SCANCEL, 0573, sent by shifted cancel key 


key_scommand 


kCMD 


*1 


KEY_SCOMMAND, 0574, salt by shifted command key 


key_scopy 


kCPY 


♦2 


KEY_SCOPY, 0575, sent by shifted copy key 


key_scr€^ate 


kCRT 


♦3 


KEY_SCREATE, 0576, sent by shifted create key 


key_sdc 


kDC 


♦4 


KEY_SEXr, 0577, sent by shifted delete-char key 
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TERMINFO (M) 



TERMINFO (M) 



Strings (cont.) 



Variable 


Cap- 

name 


Termcap 

Code 


Description 


key_sdl 


kDL 


♦5 


KEY_SDL, 0600, sent by shifted delete-lirc key 


key_select 


kslt 


*6 


KEY_SELECT, 0601, sent by select key 


key_send 


kEND 


*1 


KEY_SEND, 0602, sent by shifted end key 


key_seol 


kEOL 


♦8 


KEY_SEOL, 0603, sent by shifted clear-line key 


key_sexit 


kEXT 


*9 


KEY_SEXrr, 0604, sent by shifted exit key 


key_sf 


kind 


kF 


KEY_SF, 0520, sent by scroll-forward/ down key 


key_sfind 


kFND 


♦0 


KEY_SFIND, 0605, sent by shifted find key 


key_shelp 


kHLP 


#1 


KEY.SHELP, 0606, sent by shifted help key 


key_shome 


kHOM 


#2 


KEY.SHOME, 0607, sent by shifted home key 


key_sic 


kIC 


#3 


KEY_SIC, 0610, sent by shifted input key 


key_sleft 


kLFT 


#4 


KEY_SLEFT, 0611, sent by shifted left-arrow key 


key_smessage 


kMSG 


%a 


KEY_SMESSAGE, 0612, sent by shifted message key 


key_smove 


kMOV 


%b 


KEY_SMOVE, 0613, sent by shifted move key 


key_snext 


kNXT 


%c 


KEY_SNEXT, 0614, sent by shifted next key 


key_soptions 


kOPT 


%d 


KEY_SOPnONS, 0615, sent by shifted options key 


key_sprevious 


kPRV 


%e 


KEY_SPREVIOUS, 0616, sent by shifted prev key 


key_sprint 


kPRT 


%f 


KEY_SPRINT, 0617, sent by shifted print key 


key_sr 


kri 


kR 


KEY_SR, 0521, sent by scroll-backward/up key 


key_sredo 


kRDO 


%g 


KEY_SREIX>, 0620, sent by shifted redo key 


key_sreplace 


kRPL 


%h 


KEY_S REPLACE, 0621, sent by shifted replace key 


key_sright 


kRrr 


%i 


KEY_SRIGHT, 0622, sent by shifted right-arrow key 


key_srsume 


kRES 


%j 


KEY_SRSUME, 0623, sent by shifted resume key 


key_ssave 


kSAV 


!1 


KEY_SSAVE, 0624, sent by shifted save key 


key_ssuspend 


kSPD 


!2 


KEY_SSUSPEND, 0625, sent by shifted suspend key 


key_stab 


khts 


kT 


KEY.STAB, 0524, sent by set-tab key 


key_sundo 


kUND 


!3 


KEY_SUNDO, 0626, sent by shifted undo key 


key_suspend 


kspd 


&7 


KEY_SUSPEND, 0627, sent by suspend key 


key_undo 


kund 


&8 


KEY_UNDO, 0630, sent by undo key 


key_up 


kcuul 


ku 


KEY_UP, 0403, sent by terminal up-arrow key 


keypad_local 


rmkx 


ke 


Out of ‘ ‘keypad-transmit’ ’ mode 


keypad_xmit 


smkx 


ks 


Put terminal in “keypad-transmit’ ’ mode 


lab_f0 


IfO 


10 


Labels on function key fO if not fO 


lab_fl 


Ifl 


11 


Labels on function key fl if not fl 


lab_f2 


lf2 


12 


Labels on function key f2 if not f2 


lab_f3 


lf3 


13 


Labels on function key f3 if not f3 


lab_f4 


lf4 


14 


Labels on function key f4 if not f4 


lab_f5 


lf5 


15 


Labels on function key f5 if not f5 


lab_f6 


lf6 


16 


Labels on ftmetion key f6 if not f6 


lab_f7 


in 


17 


Labels on function key f7 if not f7 


lab_f8 


lf8 


18 


Labels on function key f8 if not f8 


lab_f9 


lf9 


19 


Labels on function key f9 if not f9 


lab_fl0 


IflO 


la 


Labels on function key flO if not flO 


label_format 


fin 


Lf 


Label format 
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TERMINFO (M) 



Strings (com.) 



Variable 


Cap- 

name 


Termcap 

Code 


label_off 


rmln 


LF 


label_on 


smln 


LO 


meta_off 


rmm 


mo 


meta_on 


smm 


mm 


micro_colunm_address mhpa 


ZY 


micro_down 


mcudl 


ZZ 


micro_left 


mcubl 


Za 


micro_right 


mcufl 


Zb 


micro_row_address 


mvpa 


Zc 


micro_up 


mcuul 


Zd 


newline 


nel 


nw 


order_of_pins 


porder 


Ze 


orig_colors 


oc 


oc 


orig_pair 


op 


op 


pad_char 


pad 


pc 


parm_dch 


dch 


DC 


parm_delete_line 


dl 


DL 


parm_down_cursor 


cud 


DO 


parm_down_micro 


mcud 


Zf 


parm_ich 


ich 


IC 


parm_index 


indn 


SF 


parm_insert_line 


il 


AL 


parm_left_cursor 


cub 


LE 


parm_left_micro 


mcub 


Zg 


parm_right_cursor 


cuf 


RI 


parm_right_micro 


mcuf 


Zh 


parm_rindex 


rin 


SR 


parm_up_cursor 


cuu 


UP 


parm_up_micro 


mcuu 


Zi 


pkey_key 


pfkey 


pk 


pkey_local 


pfloc 


pi 


pkey_xmit 


pfx 


px 


plab_norm 


pin 


pn 


print_screen 


mcO 


ps 


prtr_non 


mc5p 


pO 


prtr_off 


mc4 


Pf 


prlr_on 


mc5 


po 


pulse 


pulse 


PU 


quick_dial 


qdial 


QD 


remove_clock 


rmclk 


RC 


repeat_char 


rep 


rp 


req_for_input 


rfi 


RF 



Description 



Turn off soft labels 
Turn on soft labels 
Turn off "meta mode" 

Turn on "meta mode" (8th bit) 

Like column_address for micro adjustment t 
Like cursor_down for micro adjustment 
Like cursor_left for micro adjustment 
Like cursor_right for micro adjustment 
Like row_address for micro adjustment f 
Like cursor_up for micro adjustment 
Newline (behaves like cr followed by If) 

Matches software bits to print-head pins 
Set all color(-pair)s to the original ones 
Set default color-pair to the original one 
Pad character (rather than null) 

Delete #1 chars (G+) 

Delete #1 lines (G*) 

Move down #1 lines. (G*) 

Like parm_down_cursor for micro adjust. (G*) 
Insert #1 blank chars (G*) 

Scroll forward #1 lines. (G) 

Add #1 new blank lines (G*) 

Move cursor left #1 spaces (G) 

Like parm Jeft_cursor for micro adjust, f 
Move right #1 spaces. (G*) 

Like parm right cursor for micro adjust, f 
Scroll backward #1 lines. (G) 

Move cursor up #1 lines. (G*) 

Like parm_up_cursor for micro adjust, t 

Prog funct key #1 to type string #2 

Prog funct key #1 to execute string #2 

Prog funct key #1 to xmit string #2 

Prog label #1 to show string #2 

Print contents of the screen 

Turn on the printer for #1 bytes 

Turn off the printer 

Turn on the printer 

Select pulse dialing 

Dial phone number #1, without progress detection 
Remove time-of-day clock 
Repeat char #1 #2 times (G*) 

Send next input char (for ptys) 
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TERMINFO (M) 



TERMINFO (M) 



Strings (com.) 

Variable Description 



reset_l string 


rsl 


rl 


reset_2string 


rs2 


r2 


reset_3string 


rs3 


r3 


reset_file 


rf 


rf 


restore_cuTSor 


rc 


rc 


row_address 


vpa 


cv 


save_cursor 


sc 


sc 


scroll_forward 


ind 


sf 


scroll_reverse 


ri 


sr 


select_char_set 


scs 


Zj 


set_attributes 


sgr 


sa 


set_background 


setb 


Sb 


set_bottom_margin 


smgb 


Zk 


set_bottom_margin_parm 


smgbp 


Z1 


set_clock 


sclk 


SC 


set_color_pair 


scp 


sp 


set_foreground 


setf 


Sf 


set_left_margin 


smgl 


ML 


set_left_margin_parm 


smglp 


Zm 


setjright_margin 


smgr 


MR 


set_right_margin_parm 


smgrp 


Zn 


set_tab 


hts 


St 


set_top_margin 


smgt 


Zo 


set_top_margin_parm 


smgtp 


Zp 


set_window 


wind 


wi 


start_bit_image 


sbim 


Zq 


start_char_set_def 


scsd 


Zr 


stop_bit_image 


rbim 


Zs 


stop_char_set_def 


rcsd 


Zt 


subscript_characters 


subcs 


Zu 


superscript_characters 


supcs 


Zv 


tab 


ht 


ta 


these_cause_cr 


doer 


Zw 


to_status_line 


tsl 


ts 


tone 


tone 


TO 


underline_char 


uc 


uc 


up_half_line 


hu 


hu 


userO 


uO 


uO 


userl 


ul 


ul 


user2 


u2 


u2 


user3 


u3 


u3 


user4 


u4 


u4 



Reset terminal completely to sane modes 
Reset terminal completely to sane modes 
Reset terminal completely to sane modes 
Name of file containing reset string 
Restore cursor to position of last sc 
Vertical position absolute (G) 

Save cursor position 

Scroll text up 

Scroll text down 

Select character set t 

Define the video attributes (G) #l-#9 

Set current background color 

Set bottom margin at current line 

Set bottom margin at line #1 f 

Set time-of-day clock 

Set current color-pair 

Set current foreground colorl 

Set left margin at current line 

Set left margin at column #1 f 

Set right margin at current column 

Set right margin at column #1 1 

Set a tab in all rows, current column 

Set top margin at current line 

Set top margin at line #1 f 

Current window is lines #l-#2 cols #3-#4 (G) 

Start printing bit image graphics f 

Start definition of a character setf 

End printing bit image graphics 

End definition of a character set 

List of “subscript-able” characters 

List of “superscript-able” characters 

Tab to next 8-space hardware tab stop 

Printing any of these chars causes cr 

Go to status line, col #1 (G) 

Select touch tone dialing 
Underscore one char and move past it 
Half-line up (reverse 1/2 linefeed) 

User string 0 
User string 1 
User string 4 
User string 3 
User string 4 
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TERMINFO (M) 



Strings (com.) 



Variable 


Cap- 

name 


Termcap 

Code 


Description 


user5 


u5 


u5 


User string 5 


uscr6 


u6 


u6 


User string 6 


user? 


u7 


u7 


User string 7 


userS 


u8 


u8 


User string 8 


usei9 


u9 


u9 


User string 9 


wait_tone 


wait 


WA 


Wait for dial tone 


xoff_character 


xoffc 


XF 


X-off character 


xon_character 


xonc 


XN 


X-on character 


zero_moiion 


zerom 


Zx 


No motion for the subsequent character 
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TERMINFO (M) 



Booleans 



Cap- 

name 


Variable 


Termcap 

Code 


Description 


am 


auto_right_margin 


am 


Terminal has automatie margins 


bw 


auto_left_margin 


bw 


cubl wraps from column 0 to last column 


ccc 


can_change 


cc 


Terminal can re-define existing color 


chts 


hard_cursor 


HC 


Cursor is hard to see 


cpix 


cpi_changes_res 


YF 


Changing character pilch changes resolution 


cps 


print_rate 


Ym 


Print rate in characters per second 


crxm 


cr_cancels_micro_modem 


YB 


Using cr turns off micro mode 


cwin 


create_window 


CW 


Define win #1 to go from #2, #3 to #4,#5 


da 


memoiy_above 


da 


Display may be retained above the screen 


daisy 


has_prinl_wheel 


YC 


Printer needs operator to change character set 


dclk 


display_clock 


DK 


Display time-of-day clock 


db 


memory_below 


db 


Display may be retained below the screen 


dial 


dial_phone 


DI 


Dial phone number #1 


eo 


erase_overs trike 


eo 


Can erase overstrikes with a blank 


eslok 


status_line_esc_ok 


es 


Escape can be used on the status line 


gn 


generic_type 


gn 


Generic line type (e.g., dialup, switch) 


he 


hard_copy 


he 


Hardcopy terminal 


his 


hue_li ghtness_saturation 


hi 


Terminal uses only HLS color notation (Tektronix) 


hs 


has_status_line 


hs 


Has extra "status line" 


hz 


tilde_glitch 


hz 


Hazeltine; can’t print tilde (~) 


in 


msert_null_glitch 


in 


Insert mode distinguishes nulls 


km 


has_meta_key 


km 


Has a meta key (shift, sets parity bit) 


Ipix 


lpi_changes_res 


YG 


Changing line pitch changes resolution 


mc5i 


prtr_silent 






mir 


move_rnisert_mode 


mi 


Safe to move while in insert mode 


msgr 


move_standout_mode 


ms 


Safe to move in standout modes 


npc 


no_pad_char 


NP 


Pad character doesn’t exist 


nirmc 


non_rev_rmcup 


NR 


smeup does not reverse rmeup 


nxon 


needs_xon_xoff 


nx 


Padding won’t work, xon/xoff required 


os 


over_strike 


os 


Terminal overstrikes on hard-copy terminal 


sam 


semi_auto_right_margin 


YE 


Printing in last column causes cr 


ul 


transparent_underline 


ul 


Underline character overstrikes 


xenl 


eat_newline_glitch 


xn 


Newline ignored after 80 columns (Concept) 


xhp 


ceol_standout_glitch 


xs 


Standout not erased by overwriting (hp) 


xhpa 


col_addr_glitch 


YA 


Only positive motion for hpa/mhpa caps 


xon 


xon_xojGf 


xo 


Terminal uses xon/xoff handshaking 


xsb 


no_esc_ctlc 


xb 


Beehive (fl=escape, f2=ctrl C) 


xt 


dest_tabs_magic_smso 


xt 


Destructive tabs, magic smso char (tl061) 


xvpa 


row_addr_glitch 


YD 


Only positive motion for vpa/mvpa caps 
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Numbers 



Cap- 

name 


Variable 


Termcap 

Code 


bufsz 


buffer_capacity 


Ya 


colors 


max_colors 


Co 


cols 


columns 


CO 


cps 


print_rate 


Ym 


it 


init_tabs 


it 


Ih 


label_height 


Ih 


lines 


lines 


U 


Im 


lines_of_memory 


Im 


Iw 


label_width 


Iw 


maddr 


max_micro_address 


Yd 


mcs 


micro_col_size 


Yf 


mjump 


max_microjump 


Ye 


mis 


micro_line_size 


Yg 


ncv 


no_color_v ideo 


NC 


nlab 


num_labels 


N1 


npins 


number_of_pins 


Yh 


ore 


output_res_char 


Yi 


orhi 


output_res_horz_inch 


Yk 


orl 


output_res_line 


Yj 


orvi 


output_res_vert_inch 


Yl 


pairs 


max_pairs 


pa 


pb 


padding_baud_rate 


pb 


spinh 


dot_horz_spacing 


Yc 


spinv 


dot_vert_spacing 


Yb 


vt 


virtual_terminal 


vt 


widcs 


wide_char_size 


Yn 


wsl 


width_status_line 


ws 


xmc 


magic_cookie_glitch 


Sg 



Description 

Number of bytes buffered before printing 
Maximum number of colors on the screen 
Number of columns in a line 
Average print rate m characters per second 
Tabs initially every # spaces 
Number of rows in each label 
Number of lines on a screen or a page 
Lines of memory if > lines; 0 means varies 
Number of columns in each label 
Maximum value in mlcro_..._address 
Character step size when in micro mode 
Maximum value in parm_..._micro 
Line step size when in micro mode 
Video attributes that can’t be used with colors 
Number of labels on screen (start at 1) 

Number of pins in print-head 
Horizontal resolution in units per character 
Horizontal resolution in units per inch 
Vertical resolution in units per line 
Vertical resolution in units per inch 
Maximum number of color-pairs on the screen 
Lowest baud rate where padding needed 
Spacing of dots horizontally in dots per inch 
Spacing of pins vertically in pins per inch 
Virtual terminal number (UNIX system) 
Character step size when in double wide mode 
Number of columns in status line 
Number of blank characters left by smso or rmso 
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TERMINFO (M) 



Strings 



Cap- 

name 


Variable 


Termcap 

Code 


acsc 


acs_chars 


ac 


bel 


bell 


bl 


blink 


enter_blink_mode 


mb 


bold 


enter_bold_mode 


md 


cbt 


back_tab 


bt 


chr 


change_res_horz 


ZC 


civis 


cursor_invisible 


vi 


clear 


clear_screen 


cl 


cmdch 


command_character 


CC 


cnorm 


cursor_normal 


ve 


cpi 


change_char_pitch 


ZA 


cr 


carriage_retum 


cr 


csnm 


char_set_names 


Zy 


csr 


change_scroll_region 


cs 


cub 


parm_left_cursor 


LE 


cubl 


cursor_left 


le 


cud 


parm_down_cursor 


DO 


cuf 


parm_right_cursor 


RI 


cufl 


cursor_right 


nd 


cup 


cursor^address 


cm 


cuu 


parm_up_cursor 


UP 


cvr 


change_res_vert 


ZD 


cvvis 


cursorjvisible 


vs 


dch 


parm_dch 


DC 


dchl 


delete_character 


dc 


defc 


define_char 


ZE 


dim 


enter_dim_mode 


mh 


dl 


delete_line 


dll 


dl 


parm_delete_line 


DL 


do 


cursor_down 


do 


doer 


these_cause_cr 


Zw 


dsl 


dis_status_line 


ds 


ech 


erase_chars 


ec 


ed 


clr_eos 


cd 


el 


clr_eol 


ce 


ell 


clr_bol 


cb 


enacs 


ena_acs 


eA 


ff 


form_feed 


ff 


flash 


flash_screen 


vb 


fin 


label_format 


Lf 


fsl 


from_status_line 


fs 


hd 


down_half_line 


hd 


home 


cursor_home 


ho 



Description 

Graphic charset pairs aAbBcC - def=vtlOO 
Audible signal (bell) 

Turn on blinking 

Turn on bold (extra bright) mode 

Back tab 

Change horizontal resolution f 

Make cursor invisible 

Clear screen and home cursor (+) 

Terminal settable cmd character in prototype 
Make cursor appear normal (undo vs/vi) 
Change number of characters per inch f 
Carriage return (*) 

List of character set names 

Change to lines #1 through #2 (vtlOO) (G) 

Move cursor left #1 spaces (G) 

Move left one space. 

Move down #1 lines. (G*) 

Move right #1 spaces. (G*) 

Non-destructive space (cursor or carriage right) 
Move to row #1 col #2 (G) 

Move cursor up #1 lines. (G*) 

Change vertical resolution t 
Make cursor very visible 
Delete #1 chars (G*) 

Delete character (♦) 

Define a character in a character set 
Turn on half-bright mode 
Delete line (*) 

Delete #1 lines (G*) 

Down one line 

Printing any of these chars causes cr 
Disable status line 
Erase #1 characters (G) 

Clear to end of display (♦) 

Clear to end of line 
Clear to beginning of line, inclusive 
Enable alternate character set 
Hardcopy terminal page eject (♦) 

Visible bell (may not move cursor) 

Label format 

Return from status line 

Half-line down (forward 1/2 linefeed) 

Home cursor (if no cup) 
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Variable 


Cap- 

name 


Tcrmcap 

Code 


Description 


hook 


flash_hook 


fh 


Flash the switch hook 


hpa 


column_address 


ch 


Horizontal position absolute (G) 


ht 


lab 


la 


Tab to next 8-space hardware tab stop 


his 


sel_iab 


st 


Set a tab in all rows, current column 


hu 


up_half_line 


hu 


Half-line up (reverse 1/2 linefeed) 


hup 


hangup 


HU 


Hang -up phone 


ich 


parm_ich 


IC 


Insert #1 blank chars (G+) 


ichl 


insert_characler 


ic 


Insert character 


if 


init_file 


if 


Name of initialization file 


il 


parm_inserl_line 


AL 


Add #1 new blank lines (G*) 


ill 


insertjine 


al 


Add new blank line (*) 


ind 


scroll_forward 


sf 


Scroll text up 


indn 


parm_index 


SF 


Scroll forward #1 lines. (G) 


initc 


inilialize_color 


Ic 


Initialize the definition of color 


initp 


initialize_pair 


Ip 


Initialize color-pair 


invis 


enler_secure_mode 


mk 


Turn on blank mode (characters invisible) 


ip 


insert_padding 


ip 


Insert pad after character inserted (*) 


iprog 


init_prog 


iP 


Path name of program for initialization 


isl 


init_l string 


il 


Terminal or printer initialization string 


is2 


inil_2string 


is 


Terminal or printer initialization string 


is3 


inil_3 string 


i3 


Terminal or printer initialization string 


kBEG 


key_sbeg 


&9 


KEY_SBEG, 0572, sent by shifted beginning key 


kCAN 


key_scancel 


&0 


KEY_SCANCEL, 0573, sent by shifted cancel key 


kCMD 


key_scommand 


*1 


KEY_SCOMMAND, 0574, sent by shifted command key 


kCPY 


key_scopy 


*2 


KEY_SCOPY, 0575, sent by shifted copy key 


kCRT 


key_screate 


♦3 


KEY_SCREATE, 0576, sent by shifted create key 


kDC 


key_sdc 


♦4 


KEY_SEXI!, 0577, sent by shifted delete-char key 


kDL 


key_sdl 


♦5 


KEY_SDL, 0600, sent by shifted delete-line key 


kEND 


key_send 


*1 


KEY_SEND, 0602, sent by shifted end key 


kEOL 


key_seol 


♦8 


KEY_SEOL, 0603, sent by shifted clear-line key 


kEXT 


key_sexit 


♦9 


KEY_SEXrr, 0604, sent by shifted exit key 


kFND 


key_sfind 


♦0 


KEY_SFIND, 0605, sent by shifted find key 


kHLP 


key_shelp 


#1 


KEY_SHELP, 0606, sent by shifted help key 


kHOM 


key_shome 


#2 


KEY_SHOME, 0607, sent by shifted home key 


kIC 


key_sic 


#3 


KEY_SIC, 0610, sent by shifted input key 


kLFT 


key_sleft 


#4 


KEY_SLEFT, 0611, sent by shifted left-arrow key 


kMOV 


key_smove 


b 


KEY_SMOVE, 0613, sent by shifted move key 


kMSG 


key_smessage 


%a 


KEY_SMESSAGE, 0612, sent by shifted message key 


kNXT 


key_snext 


%c 


KEY_SNEXT, 0614, sent by shifted next key 


kOPT 


key_soptions 


%d 


KEY_SOPTIONS, 0615, sent by shifted options key 


kPRT 


key_sprint 


%f 


KEY_SPRINT, 0617, sent by shifted print key 


kPRV 


key_sprevious 


%e 


KEY_SPREVIOUS, 0616, sent by shifted prev key 


kRDO 


key_sredo 


%g 


KEY_SREDO, 0620, sent by shifted redo key 


kRES 


key_srsume 


%j 


KEY_SRSUME, 0623, sent by shifted resume key 
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Variable 


Cap- 

name 


Termcap 

Code 


kRIT 


key_sright 


%i 


kRPL 


key_sreplace 


%h 


kSAV 


key_ssave 


!1 


kSPD 


key_ssuspend 


!2 


kUND 


key_sundo 


!3 


kal 


key_al 


K1 


ka3 


key_a3 


K3 


kb2 


key_b2 


K2 


kbeg 


key_beg 


@1 


kbs 


key_backspace 


kb 


kcl 


key_cl 


K4 


kc3 


key_c3 


K5 


kcan 


key_cancel 


@2 


kebt 


key_btab 


kB 


kelo 


key_close 


@3 


kclr 


key_clear 


kC 


kemd 


key_command 


@4 


kepy 


key_copy 


@5 


kert 


key_create 


@6 


ketab 


key_ctab 


kt 


kcubl 


key_left 


kl 


kcudl 


key_down 


kd 


kcufl 


key_right 


kr 


kcuul 


key_up 


ku 


kdchl 


key_dc 


kD 


kdll 


key_dl 


kL 


ked 


key_eos 


ked 


kel 


key_eol 


kE 


kend 


key_end 


@1 


kent 


key_enter 


@8 


kext 


key_exit 


@9 


kfO 


key_f0 


kO 


kfl 


key_fl 


kl 


kflO 


key_fl0 


k; 


kfll 


key_f 1 1 


Fl 


kfl2 


key_fl2 


F2 


kfl3 


key_fl3 


F3 


kfl4 


key_fl4 


F4 


kfl5 


key_fl5 


F5 


kfl 6 


key_fl6 


F6 


kfl7 


key_fl7 


F7 


kfl8 


key_fl8 


F8 


kfl9 


key_fl9 


F9 


kf2 


key_f2 


k2 



Description 



KEY_S RIGHT, 0622, sent by shifted right- arrow key 
KEY_S REPLACE, 0621, sent by shifted replace key 
KEY_SSAVE, 0624, sent by shifted save key 
KEY_SSUSPEND, 0625, sent by shifted suspend key 
KEY_SUNDO, 0626, sent by shifted undo key 
KEY_A1, 0534, upper left of keypad 
KEY_A3, 0535, upper right of keypad 
KEY_B2, 0536, center of keypad 
KEY_BEG, 0542, sent by beg(inning) key 
KEY_BACKSPACE, 0407, sent by backspace key 
KEY_C1, 0537, lower left of keypad 
KEY_C3, 0540, lower right of keypad 
KEY_CANCEL, 0543, sent by cancel key 
KEY_BTAB, 0541, sent by back-tab key 
KEY_CLOSE, 0544, sent by close key 
KEY_CLEAR, 0515, sent by dear-screen or erase key 
KEY_COMMAND, 0545, sent by cmd (command) key 
KEY_COPY, 0546, sent by copy key 
KEY_CREATE, 0547, sent by create key 
KEY_CTAB, 0525, sent by dear-tab key 
KEY_LEFT, 0404, sent by terminal left-arrow key 
KEY_DOWN, 0402, sent by terminal down-arrow key 
KEY_RIGHT, 0405, sent by terminal right-arrow key 
KEY_UP, 0403, sent by terminal up-arrow key 
KEY_DC, 0512, sent by delete-character key 
KEY_DL, 0510, sent by delete-line key 
KEY_EOS, 0516, sent by clear-to-end-of-screen key 
KEY_EOL, 0517, sent by dear-to-end-of-line key 
KEY_END, 0550, sent by end kee 
KEY_ENTER, 0527, sent by enter/send key 
KEY_EXrr, 0551, sent by exit key 
KEY_F(0), 0410, sent by function key 10 
KEY_F(C), 0411, sent by function key fl 
KEY_F(ADM), 0422, sent by function key flO 
KEY_F(ADM), 0423, sent by function key fl 1 
KEY_F(ADM), 0424, sent by function key fl2 
KEY_F(ADM), 0425, sent by function key fl3 
KEY_F(ADM), 0426, sent by function key fl4 
KEY_F(ADM), 0427. sent by function key fl5 
KEY_F(ADM), 0430, sent by function key fl6 
KEY_F(ADM), 0431, sent by function key fl7 
KEY_F(ADM), 0432, sent by function key fl8 
KEY_F(ADM), 0433, sent by function key fl9 
KEY_F(S), 0412, sent by function key f2 
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Strings (cont.) 



Variable 


Cap- 

name 


Termcap 

Code 


Description 


kOO 


key_f20 


FA 


KEY_F(20), 0434, sent by function key f20 


kf21 


key_f21 


FB 


KEY_F(21), 0435, sent by function key f21 


kf22 


key_f22 


FC 


KEY_F(22), 0436, sent by function key f22 


kf23 


key_f23 


FD 


KEY_F(23), 0437, sent by function key f23 


kf24 


key_f24 


FE 


KEY_F(24), 0440, sent by function key f24 


kf25 


key_f25 


FF 


KEY^F(25), 0441, sent by function key f25 


kf26 


key_f26 


FG 


KEY_F(26), 0442, sent by function key f26 


kf27 


key_f27 


FH 


KEY_F(27), 0443, sent by function key f27 


kf28 


key_f28 


¥l 


KEY_F(28), 0444, sent by function key £28 


kf29 


key_f29 


FJ 


KEY_F(29), 0445, sent by function key £29 


kO 


key_B 


k3 


KEY_F(S), 0413, sent by function key B 


kOO 


key_B0 


FK 


KEY_F(S), 0446, sent by function key BO 


kOl 


key_Bl 


FL 


KEY_F(S), 0447, sent by function key B1 


k02 


key_B2 


FM 


KEY_F(S), 0450, sent by function key B2 


kf33 


key_B3 


FN 


KEY_F(ADM), 0451, sent by fimction key fl3 


kD4 


key_B4 


FO 


KEY_F(S), 0452, sent by function key B4 


k05 


key_B5 


FP 


KEY_F(S), 0453, sent by function key B5 


kB6 


key_B6 


FQ 


KEY_F(S), 0454, sent by function key B6 


kf37 


key_B7 


FR 


KEY_F(S), 0455, sent by function key B7 


kf38 


key_B8 


FS 


KEY_F(S), 0456, sent by function key B8 


kf39 


key_B9 


FT 


KEY_F(S), 0457, sent by function key B9 


kf4 


key_f4 


k4 


KEY_F(F), 0414, sent by function key f4 


kf40 


key_f40 


FU 


KEY_F(40), 0460, sent by function key f40 


kf41 


key_f41 


FV 


KEY_F(41), 0461, sent by function key f41 


kf42 


key_f42 


FW 


KEY_F(42), 0462, sent by fimction key f42 


kf43 


key_f43 


FX 


KEY_F(43), 0463, sent by function key f43 


kf44 


key_f44 


FY 


KEY_F(44), 0464, sent by function key f44 


kf45 


key_f45 


FZ 


KEY_F(45), 0465, sent by function key f45 


kf46 


key_f46 


Fa 


KEY_F(46), 0466, sent by function key f46 


kf47 


key_f47 


Fb 


KEY_F(47), 0467, sent by function key f47 


kf48 


key_f48 


Fc 


KEY_F(48), 0470, sent by function key f48 


kf49 


key_f49 


Fd 


KEY_F(49), 0471, sent by function key f49 


kf5 


key_f5 


k5 


KEY_F(M), 0415, sent by function key f5 


kfSO 


key_f50 


Fe 


KEY_F(50), 0472, sent by function key f50 


kf51 


key_f51 


Ff 


KEY_F(51), 0473, sent by function key f51 


kf52 


key_f52 


Fg 


KEY_F(52), 0474, sent by function key f52 


kf53 


key_f53 


Fh 


KEY_F(53), 0475, sent by function key f53 


kf54 


key_f54 


Fi 


KEY_F(54), 0476, sent by function key £54 


kf55 


key_f55 


Fj 


KEY_F(55), 0477, sent by function key f55 


kf56 


key_f56 


Fk 


KEY_F(56), 0500, sent by function key £56 


kf57 


key_f57 


FI 


KEY_F(57), 0501, sent by function key f57 


kf58 


key_f58 


Fm 


KEY_F(58), 0502, sent by function key f58 


kf59 


key_f59 


Fn 


KEY^F(59), 0503, sent by function key f59 


kf6 


key_f6 


k6 


KEY_F(6), 0416, sent by function key f6 
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Strings (cont.) 



Variable 


Cap- 

name 


Termcap 

Code 


Description 


kf60 


key_f60 


Fo 


KEY_F(60), 0504, sent by function key f60 


kf61 


key_f61 


Fp 


KEY_F(61), 0505, sent by function key f61 


kf62 


key_f62 


Fq 


KEY_F(62), 0506, sent by function key f62 


kf63 


key_f63 


Fr 


KEY_F(63), 0507, sent by function key f63 


kf7 


key_f7 


k7 


KEY_F(7), 0417, sent by function key f7 


kf8 


key_f8 


k8 


KEY_F(8), 0420, sent by function key f8 


kf9 


key_f9 


k9 


KEY_F(9), 0421, sent by function key f9 


kfhd 


key_find 


@0 


KEY_FIND, 0552, sent by find key 


khlp 


key_help 


%1 


KEY_HELP, 0553, sent by help key 


khome 


key_home 


kh 


KEY.HOME, 0406, sent by home key 


khts 


key_stab 


kT 


KEY_STAB, 0524, sent by set-tab key 


kichl 


keyjc 


kl 


KEYJC, 0513, sent by ins-char/entCT ins-mode key 


kill 


key_il 


kA 


KEY_IL, 0511, sent by insert-line key 


kind 


key_sf 


kF 


KEY_SF, 0520, sent by scroll-forward/ down key 


kll 


keyjl 


kH 


KEY_LL, 0533, sent by home-down key 


kmov 


key_move 


%4 


KEY.MOVE, 0556, sent by move key 


kmrk 


key_mark 


%2 


KEY_MARK, 0554, sent by mark key 


kmsg 


key_message 


%3 


KEY_MESSAGE, 0555, sent by message key 


knp 


key_npage 


kN 


KEY_NPAGE, 0522, sent by next-page key 


knxt 


key_next 


%5 


KEY_NEXT, 0557, sent by next-object key 


kopn 


key_open 


%6 


KEY_OPEN, 0560, SCTit by open key 


kopt 


key_options 


%7 


KEY_OPnONS, 0561, sent by options key 


kpp 


key_ppage 


kP 


KEY_PPAGE, 0523, sent by previous-page key 


kprt 


key_print 


%9 


KEY_PRINT, 0532, sent by print or copy key 


kprv 


key_previous 


%8 


KEY_PREVIOUS, 0562, sent by previous-object key 


krdo 


key_redo 


%0 


KEY_REIX), 0563, sent by redo key 


kref 


key_reference 


&1 


KEY_REFERENCE, 0564, sent by ref(erence) key 


kres 


key_resume 


&5 


KEY_RESUME, 0570, sent by resume key 


krfr 


key_refresh 


&2 


KEY_REFRESH, 0565, sent by refresh key 


kri 


key_sr 


kR 


KEY_SR, 0521, sent by scroll-backward/up key 


krmir 


key_eic 


kM 


KEY_EIC, 0514, sent by rmir or smir in insert mode 


krpl 


key_replace 


&3 


KEY_REPLACE, 0566, sent by replace key 


krst 


key_restart 


&4 


KEY_RESTART, 0567, sent by restart key 


ksav 


key_save 


&6 


KEY_SAVE, 0571, sent by save key 


kslt 


key_select 


♦6 


KEY_S ELECT, 0601, sent by select key 


kspd 


key_suspend 


&7 


KEY_SUSPEND, 0627, sent by suspend key 


ktbc 


key_catab 


ka 


KEY_CATAB, 0526, sent by clear-all-tabs key 


kund 


key_undo 


&8 


KEY_UNDO, 0630, sent by undo key 


IfO 


lab.fO 


10 


Labels on function key fO if not fO 


Ifl 


lab_fl 


11 


Labels on function key fl if not fl 


IflO 


lab.flO 


la 


Labels on function key flO if not flO 


lf2 


lab_f2 


12 


Labels on function key f2 if not f2 


lf3 


lab_f3 


13 


Labels on function key f3 if not D 


lf4 


lab_f4 


14 


Labels on function key f4 if not f4 
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Variable 

name 


Termcap 

Code 


Description 


lf5 


lab_f5 


15 


Labels on function key f5 if not f5 


lf6 


lab_f6 


16 


Labels on function key f6 if not f6 


in 


lab_f7 


17 


Labels on function key f7 if not f7 


If8 


lab_f8 


18 


Labels on function key f8 if not f8 


lf9 


lab_f9 


19 


Labels on function key f9 if not f9 


11 


cursor_io_ll 


11 


Last line, first column (if no cup) 


Ipi 


change_line_pitch 


ZB 


Change number of lines per inch t 


ma 


max_attributes 


ma Maximum combined video attributes terminal can display 


mcO 


print_screen 


ps 


Print contents of the screen 


mc4 


prtr_off 


pf 


Turn off the printer 


mc5 


prtr_on 


po 


Turn on the printer 


mc5p 


prtr_non 


pO 


Turn on the printer for #1 bytes 


mcub 


parm_left_micro 


Zg 


Like parm_left_cursor for micro adjust, f 


mcubl 


micro_left 


Za 


Like cursor_lefl for micro adjustment 


meud 


parm_down_micro 


Zf 


Like parm_down_cursor for micro adjust. (G+) 


mcudl 


micro_down 


zz 


Like cursor down for micro adjustment 


meuf 


parm_ri ght_micro 


Zh 


Like parm_right_cursor for micro adjust, t 


mcufl 


micro_right 


Zb 


Like cursor_right for micro adjustment 


mcuu 


parm_up_micro 


Zi 


Like parm_up_cursor for micro adjust, t 


mcuul 


micro_up 


Zd 


Like cursor_up for micro adjustment 


mge 


clear_margins 


MC 


Clear all margins (top, bottom, and sides) 


mhpa 


micro_column_address 


ZY 


Like column_address for micro adjustment f 


mrcup 


cursor_mem_address 


CM 


Memory relative cursor addressing (G) 


mvpa 


micro_row_address 


Zc 


Like row_address for micro adjustment f 


ndscr 


non_desl_scroll_region 


ND 


Scrolling region is non-destructive 


nel 


newline 


nw 


Newline (behaves like cr followed by If) 


oc 


orig_colors 


oc 


Set all color(-pair)s to the original ones 


op 


orig_pair 


op 


Set default color-pair to the original one 


pad 


pad_char 


pc 


Pad character (rather than null) 


pause 


fixed_pause 


PA 


Pause for 2-3 seconds 


pfkey 


pkey_key 


pk 


Prog funct key #1 to type string #2 


pfloc 


pkey_local 


pi 


Prog funct key #1 to execute string #2 


pfx 


pkey_xmit 


px 


Prog funct key #1 to xmit string #2 


pin 


plab_norm 


pn 


Prog label #1 to show string #2 


porder 


order_of_pins 


Ze 


Matches software bits to print-head pins 


prot 


enter_protected_mode 


mp 


Turn on protected mode 


pulse 


pulse 


PU 


Select pulse dialing 


qdial 


quick_dial 


QD 


Dial phone number #1, without progress detection 


rbim 


stop_bit_image 


Zs 


End printing bit image graphics 


re 


restore_cursor 


rc 


Restore cursor to position of last sc 


resd 


stop_char_set_def 


Zt 


End definition of a character set 


rep 


repeat_char 


iP 


Repeat char #1 #2 times (G+) 


rev 


enter_reverse_mode 


mr 


Turn on reverse video mode 


rf 


reset_file 


rf 


Name of file containing reset string 
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Variable 


Cap- 

name 


Termcap 

Code 


Description 


rfi 


req_for_input 


RF 


Send next input char (for ptys) 


ri 


scroll_reverse 


sr 


Scroll text down 


rin 


parm_rindex 


SR 


Scroll backward #1 lines. (G) 


ritm 


exit_italics_mode 


ZR 


Disable italics 


rim 


cxit_leftward_mode 


zs 


Enable rightward (normal) carriage motion 


rmacs 


exit_alt_charset_mode 


ae 


End alternate character set 


rmam 


exit_am_mode 


RA 


Turn off automatic margins 


rmclk 


remove_clock 


RC 


Remove time-of-day clock 


rmcup 


exit_ca_mode 


te 


String to end programs that use cup 


rmdc 


exit_delete_mode 


ed 


End delete mode 


rmicm 


exil_micro_mode 


ZT 


Disable micro motion capabilities 


rmir 


exit_insert_mode 


ei 


End insert mode 


rmkx 


keypad_local 


ke 


Out of ‘ ‘keypad-transmit’ ’ modey 


rmln 


labeLoff 


LF 


Turn off soft labels 


rmm 


meta_off 


mo 


Turn off "meta mode" 


rmp 


char_padding 


rP 


Like ip but when in replace mode 


rmso 


exit_standout_mode 


se 


End standout mode 


rmul 


exit_underline_mode 


ue 


End underscore mode 


rmxon 


exit_xon_mode 


RX 


Turn off xon/xoff handshaking 


rsl 


reset_l string 


rl 


Reset terminal completely to sane modes 


rs2 


reset_2string 


r2 


Reset terminal completely to sane modes 


rs3 


reset_3string 


r3 


Reset terminal completely to sane modes 


rshm 


exit_shadow_mode 


ZU 


Disable shadow printing 


rsubm 


exit_subscript_mode 


zv 


Disable subscript printing 


rsupm 


exit_superscript_mode 


zw 


Disable superscript printing 


rum 


exit_upward_mode 


zx 


Enable downward (normal) carriage motion 


rwidm 


exit_doublewide_mode 


ZQ 


Disable double wide printing 


sbim 


start_bit_image 


Zq 


Start printing bit image graphics t 


sc 


save_cursor 


sc 


Save cursor position 


sclk 


set_clock 


SC 


Set time-of-day clock 


scp 


set_color_pair 


sp 


Set current color-pair 


scs 


select_char_set 


Zj 


Select character set f 


scsd 


start_char_set_def 


Zr 


Start definition of a character set t 


sdrfq 


enter_draft_quality 


ZG 


Set draft quality print 


setb 


set_background 


Sb 


Set current background color 


self 


set_foreground 


Sf 


Set current foreground color 


sgr 


set_attributes 


sa 


Define the video attributes #l-#9 (G) 


sgrO 


exit_attribute_mode 


me 


Turn off all attributes 


sitm 


enter_italics_mode 


ZH 


Enable italics 


slm 


enter_leftward_mode 


ZI 


Enable leftward carriage motion 


smacs 


enter_alt_chaiset_mode 


as 


Start alternate character set 


smam 


enter_am_mode 


SA 


Turn on automatic margins 


smcup 


enter_ca_mode 


ti 


String to begin programs that use cup 


smdc 


enter_delete_mode 


dm 


Delete mode (enter) 
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Cap- 

name 


Termcap 

Code 


Description 


smgb 


set_bottom_margin 


Zk 


Set bottom margin at current line 


smgbp 


set_bottom_margin_parm 


Zl 


Set bottom margin at line #1 f 


smgl 


set_left_margin 


ML 


Set left margin at current line 


smglp 


set_left_margin_parm 


Zm 


Set left margin at column #1 1 


smgr 


set_right_margin 


MR 


Set right margin at current column 


smgrp 


set_right_margin_parm 


Zn 


Set right margin at column #1 f 


smgt 


set_top_margin 


Zo 


Set top margin at current line 


smgtp 


set_top_margin_parm 


Zp 


Set top margin at line #1 f 


smicm 


enter_micro_mode 


ZJ 


Enable micro motion c^abilities 


smir 


enter_insert_mode 


im 


Insert mode (enter) 


smkx 


keypad_xmit 


ks 


Put terminal in ‘ ‘keypad-transmit’ ’ mode 


smln 


label_on 


LO 


Turn on soft labels 


smm 


meta_on 


mm 


Turn on "meta mode" (8th bit) 


smso 


enter_standout_mode 


so 


Begin standout mode 


smxon 


enter_xon_mode 


SX 


Turn on xon/xoff handshaking 


snlq 


enter_near_letter_quality 


ZK 


Set near-letter qualiQ^ print 


snrmq 


enter_normal_quality 


ZL 


Set normal quality print 


sshm 


enter_shadow_mode 


ZM 


Enable shadow printing 


ssubm 


enter_subscript_mode 


ZN 


Enable subscript printing 


ssupm 


enter_superscript_mode 


ZO 


Enable superscript printing 


subcs 


subscript_characters 


Zu 


List of “subscript-able” characters 


sum 


enter_upward_mode 


ZP 


Enable upward carriage motion 


supcs 


superscript_characters 


Zv 


List of “superscript-able” characters 


swidm 


enter_doublewide_mode 


ZF 


Enable double wide printing 


tbc 


clear_all_tabs 


ct 


Clear all tab stops 


tone 


tone 


TO 


Select touch tone dialing 


tsl 


to_status_line 


ts 


Go to status line, col #1 (G) 


uO 


userO 


uO 


User string 0 


ul 


userl 


ul 


User string 1 


u2 


user2 


u2 


User string 2 


u3 


user3 


u3 


User string 3 


u4 


user4 


u4 


User string 4 


u5 


userS 


u5 


User string 5 


u6 


user6 


u6 


User string 6 


u7 


user? 


u7 


User string 7 


u8 


userS 


u8 


User string 8 


u9 


usei9 


u9 


User string 9 
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Variable 

name 


Termcap 

Code 


Description 



uc 


underline_char 


uc 


Underscore one char and move past it 


up 


cursor_up 


cuul 


Upline (cursor up) 


vpa 


row_address 


cv 


Vertical position absolute (G) 


wait 


wait_tone 


WA 


Wait for dial tone 


wind 


set_window 


wi 


Current window is lines #l-#2 cols #3-#4 (G) 


wingo 


goto_window 


WG 


Got to window #1 


wnum 


maximum_windows 


MW 


Maximum number of definable windows 


xoffc 


xoff_character 


XF 


X-off character 


xonc 


xon_character 


XN 


X-on character 


zerom 


zero_motion 


Zx 


No motion for the subsequent character 



Sample Entry 



The following entry, which describes the AT&T 610 terminal, is 
among the more complex entries in the terminfo file as of this writing. 

610 I 610bct I ATT610 | att610 I AT&T 610; 80 column; 98key keyboard 
artv eslok, hs, mir, msgr, xenl, xon, 
cols#80, it#8, lh#2, lines#24, lw#8, nlab#8, wsl#80, 
acsc=' 'aaffggj jkkllmnnnnooEpqqrrssttuuvvwwxxyyzz{ { | 1 }} , 

bel="G, blink=\E[5m, bolct=\E[lm, cbt=\E[Z, 
civis=\E [7251, clear=\E [H\E [ J, cnonrF=\E [?25h\E [7121, 
cr=\r, csr=\E[%i%pl%d;%p2%dr, cub=\E[%pl%dD, cubl=\b, 
cud=\E[%pl%c©, cudl=\E[B, cuf=\E[%pl%dC, cufl=\E[C, 
cup=\E[%i%pl%d;%p2%dH, cuu=\E [%pl%dA, cuul=\E[A, 
cwis=\E[712;25h, dch=\E [%pl%dP, dchl=\E[P, dim=\E[2m, 
dl=\E[%pl%dM, dll=\E[M, ed=\E[J, el=\E[K, ell=\E[lK, 
flash=\E[75h$<200>\E[751, fsl=\E8, horte=\E[H, ht=\t, 
ich=\E[%pl%d0, il=\E[%pl%dL, ill=\E[L, ind=\ED, 
invis=\E[8m, 

isl=\E[8;0 I \E[73;4;5;13;151\E[13;201\E[77h\E[12h\E(B\E)0, 
is2=\E[Om^O, is3=\E(B\E)0, kLFT=\E[\s0, kRIT=\E[\sA, 
kbs=\b, kcbt=\E[Z, kclr=\E[2j, kcubl=\E[D, kcudl=\E[B, 
kcufl=\E[C, kcuul=\E[A, kfl=\EOc, kflO=\ElS^, 
kfll=\ENq, kfl2=\ENr, kfl3=\ENs, kfl4=\ENt, kf2=\EOd, 
kf3=\EOe, kf4=\EOf, kf5=\EOg, kf6=\EOh, kf7=\EOi, 
kf8=\EOj, kf9=\ENo, khane=\E[H, kind=\E[S, kri=\E[T, 

11=\E[24H, mc4=\E[74i, irc5=\E[75i, nel=\EE, 
pfx=\E [%pl%d; %p2%l%02dq\s\s\sF%pl%ld\s\s\s\s\s 
\s\s\s\s\s\s%p2%s, 

pln=\E [ %pl%d; 0 ; 0 ; 0q%p2 % : - 1 6 . 1 6s , rc=\E8 , rev=\E [ 7m, 
ri=\EM, rmacs="0, rmir=\E[41, ntiln=\E[2p, rmso=\E[m, 
rmul=\E[m, rs2=\Ec\E [731, sc=\E7, 

sgr=\E [0%7%p6%t; 1%; %7%p5%t ;2%; %7%p2%t ; 4%; %7%p4%t ; 5%; 

%7%p3%pl% I %t;7%;%7%p7%t;8%;m%7%p9%t"N%e'‘0%;, 

sgrO=\E [rn'O, smacs='‘N, smir=\E[4h, smln=\E[p, 
smso=\E[7m, smul=\E[4m, tsl=\E7\E[25;%i%pl%dx, 

T^pes of Capabilities in the Sample Entry 

The sample entry shows the formats for the three types of terminfo 
capabilities listed: Boolean, Numeric, and String. The names of 
Boolean capabilities are often listed as abbreviations or acronyms. 
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such as am (short for "automatic margins") in the sample entry. 
("Automatic margins" is a short description of an automatic return and 
linefeed when the end of a line is reached.) 

Numeric capabilities are followed by the character ‘#’ and then the 
value. Thus, in the sample, cols (which shows the number of columns 
available on a terminal) gives the value 80 for the AT&T 610. (Values 
for numeric capabilities may be specified in decimal, octal or hexa- 
decimal, using normal C conventions.) 

Finally, string-valued capabilities such as el (clear to end of line 
sequence) are listed by a two- to five-character capname, an ‘=’, and a 
string ended by the next occurrence of a comma. A delay in mil- 
liseconds may appear anywhere in such a capability, enclosed in $<..> 
brackets, as in el=\EK$<3>. Padding characters are supplied by 
tputs( ). The delay can be any of the following: a number (5), a num- 
ber followed by a ’ (5*), a number followed by a 7’ (5/), or a num- 
ber followed by both ( 5 */). A shows that the padding required is 
proportional to the number of lines affected by the operation, and the 
amount given is the per-affected-unit padding required. (In the case of 
insert characters, the factor is still the number of lines affected. This 
is always 1 unless the terminal has in and the software uses it.) When 
a ’ is specified, it is sometimes useful to give a delay of the form 3.5 
to specify a delay per unit to tenths of milliseconds. (Only one 
decimal place is allowed.) 

A 7’ indicates that the padding is mandatory. Absence of a 7’ is not 
shown, if the terminal has xon defined. Padding information is 
advisory and will be used only for cost estimates or when the terminal 
is in raw mode. Mandatory padding will be transmitted regardless of 
the setting of xon. 

A number of escape sequences are provided in the string valued capa- 
bilities for easy encoding of characters there. Both \E and \e map to 
an ESCAPE character, maps to a control -x for any appropriate x, 
and the sequences \n, \1, \r, \t, \b, \f, and \s give a newline, linefeed, 
return, tab, backspace, formfeed, and space, respectively. Other 
escapes include: for caret (^); W for backslash (\); \, for comma 

( ,); A: for colon ( : ); and \0 for null. (\0 will actually produce \200, 
which does not terminate a string but behaves as a null character on 
most terminals.) Finally, characters may be given as three octal digits 
after a backslash (e.g.,\123). 

Sometimes individual capabilities must be commented out. To do 
this, put a period before the capability name. For example, see the 
second ind in the example above. Note that capabilities are defined in 
a left-to-right order and, therefore, a prior definition will override a 
later definition. 
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Preparing Descriptions 

The most effective way to prepare a terminal description is by imitat- 
ing the description of a similar terminal in terminfo and to build up a 
description gradually, using partial descriptions with v/(C) to check 
that they are correct. Be aware that a very unusual terminal may 
expose deficiencies in the ability of the terminfo file to describe it or 
the inability of v/(C) to work with that terminal. To test a new termi- 
nal description, set the environment variable TERMINFO to a path- 
name of a directory containing the compiled description you are work- 
ing on and programs will look there rather than in I usr/libl terminfo . 
To get the padding for insert-line correct (if the terminal manufacturer 
did not document it) a severe test is to comment out xon, edit a large 
file at 9600 baud with v/(C), delete 16 or so lines from the middle of 
the screen, then hit the u key several times quickly. If the display is 
corrupted, more padding is usually needed. A similar test can be used 
for insert-character. 



Section 1-1: Basic Capabilities 

The number of columns on each line for the terminal is given by the 
cols numeric capability. If the terminal has a screen, then the number 
of lines on the screen is given by the lines capability. If the terminal 
can clear its screen, leaving the cursor in the home position, then this 
is given by the clear string capability. If the terminal overstrikes 
(rather than clearing a position when a character is struck over) then it 
should have the os capability. If the terminal is a printing terminal, 
with no soft copy unit, give it both he and os. (os applies to storage 
scope terminals, such as the Tektronix 4010 series, as well as hard- 
copy and APL terminals.) If there is a code to move the cursor to the 
left edge of the current row, give this as cr. (Normally this will be 
carriage return, control M.) If there is a code to produce an audible 
signal (such as a bell or a beep), specify it as bel. If the terminal uses 
the xon-xoff flow-control protocol, like most terminals, specify xon. 

If there is a code to move the cursor one position to the left (such as 
backspace), that capability should be given as cubl. Similarly, codes 
to move to the right, up, and down should be given as cufiL, cuul, and 
cudl. These local cursor motions should not alter the text they pass 
over; for example, you would not normally use “cufl=\s” because the 
space would erase the character moved over. 

A very important point here is that the local cursor motions encoded in 
terminfo are undefined at the left and top edges of a screen terminal. 
Programs should never attempt to backspace around the left edge, 
unless bw is given, and should never attempt to go up locally off the 
top. In order to scroll text up, a program will go to the bottom left 
comer of the screen and send the ind (index) string. 
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To scroll text down, a program goes to the top left comer of the screen 
and sends the ri (reverse index) string. The strings ind and ri are 
undefined when not on their respective comers of the screen. 

Parameterized versions of the scrolling sequences are indn and rin 
which have the same semantics as ind and ri except that they take one 
parameter, and scroll that many lines. They are also undefined except 
at the appropriate edge of the screen. 

If the terminal wraps around to the beginning of the next line when it 
reaches the right margin, then it should have the am capability. The 
am capability tells whether the cursor sticks at the right edge of the 
screen when text is output, but this does not necessarily apply to a 
cufl from the last column. The only local motion which is defined 
from the left edge is if bw is given, then a cubl from the left edge will 
move to the right edge of the previous row. If bw is not given, the 
effect is undefined. TTiis is useful for drawing a box around the edge 
of the screen, for example. If the terminal has switch selectable 
automatic margins, the terminfo file usually assumes that this is on; 
i.e., am. If the terminal has a command which moves to the first 
column of the next line, that command can be given as nel (newline). 
It does not matter if the command clears the remainder of the current 
line, so if the terminal has no cr and If it may still be possible to craft 
a working nel out of one or both of them. 

These capabilities suffice to describe hardcopy and screen terminals. 
Thus the model 33 teleprinter is described as: 

he, os, xon 
cols#72, 

bel="G, cr=\r, cudl=\n, ind=\n, 

while the Lear Siegler ADM-3 is described as: 

adm3 1 Isi adm3, 

am, bel="G, clear="Z, cols#80, cr="M, cubl="H, 
cudl="J, ind="J, lines#24. 

Section 1-2: Parameterized Strings 

Cursor addressing and other strings requiring parameters in the termi- 
nal are described by a parameterized string capability, with printf(S)- 
like escapes (%x) in it. For example, to address the cursor, the cup 
capability is given, using two parameters: the row and column to 
address to. (Rows and columns are numbered from zero and refer to 
the physical screen visible to the user, not to any unseen memory.) If 
the terminal has memory relative cursor addressing, that can be indi- 
cated by mrcup. 

The parameter mechanism uses a stack and special % codes to mani- 
pulate it in the manner of a Reverse Polish Notation (postfix) calcula- 
tor. Typically a sequence will push one of the parameters onto the 
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stack and then print it in some format. Often more complex opera- 
tions are necessary. Binary operations are in postfix form with the 
operands in the usual order. That is, to get x-5 one would use 
%gx%{5}%-. 

The % encodings have the following meanings: 

%% outputs 

^o[[: Iflags] [width [ .precision] ] [doxXs] 

as in printf, flags are [-4^] and space 
%c print popO gives %c 

%p[l-9] push i^^ parm 

%P[a-z] set variable [a-z] to pop() 

%g[a-z] get variable [a-z] and push it 

%’c’ push char constant c 

%[nn} push decimal constant nn 

%\ push strlen(popO) 



%+ %- %* %/ %m 

arithmetic (%m is mod): push(pop() op pop()) 
%& %\ bit operations: push(pop() op pop()) 

%= %> %< logical operations: push(pop() op pop()) 

%A %0 logical operations: and, or 

%! %~ unary operations: push(op pop()) 

%i (for ANSI terminals) 

add 1 to first parm, if one parm present, 

or first two parms, if more than one parm present 



^ expr %t thenpart %e elsepart %; 

if-then-else, %e elsepart is optional; 

else-if’s are possible ala Algol 68: 

%? c^ %t b^ %e c^ %t b %e c^ %t b^ %e c 

c. are conditions, b. are bodies. 

1 ’ 1 



%t b. %e b.%; 
4 4 5 



If the flag is used with “%[doxXs]”, then a colon (:) must be 
placed between the and the to differentiate the flag from the 
binary operator, .e.g., “%:-16.16s”. 



Consider the Hewlett-Packard 2645, which, to get to row 3 and 
column 12, needs to be sent \E&al2c03Y padded for 6 milliseconds. 
Note that the order of the rows and columns is inverted here, and that 
the row and column are zero-padded as two digits. Thus its cup capa- 
bility is “cup=\E&a%p2%2.2dc%pl%2.2dY$<6>”. 



The Micro-Term ACT-IV needs the current row and column sent pre- 
ceded by a '"T, with the row and column simply encoded in binary, 
“cup=^T%pl%c%p2%c”. Terminals which use “%c” need to l^ 
able to backspace the cursor (cubl), and to move the cursor up one 
line on the screen (cuul). This is necessary because it is not always 
safe to transmit \n, ^D, and \r, as the system may change or discard 
them. (The library routines dealing with terminfo set tty modes so that 
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tabs are never expanded, so \t is safe to send. This turns out to be 
essential for the Ann Arbor 4080.) 

A final example is the LSI ADM-3a, which uses row and column offset 
by a blank character, thus 

“cup=::\E=%pl%^s’%+%c%p2%^s’%+%c’^ After sending “\E=”, 
this pushes the first parameter, pushes the ASCII value for a space (S), 
adds them (pushing the sum on the stack in place of the two previous 
values), and outputs that value as a character. Then the same is done 
for the second parameter. More complex arithmetic is possible using 
the stack. 



Section 1-3: Cursor Motions 

If the terminal has a fast way to home the cursor (to very upper left 
comer of screen) then this can be given as home; similarly a fast way 
of getting to the lower left-hand comer can be given as 11; this may 
involve going up with cuul from the home position, but a program 
should never do this itself (unless 11 does) because it can make no 
assumption about the effect of moving up from the home position. 
Note that the home position is the same as addressing to (0,0): to the 
top left comer of the screen, not of memory. (Thus, the \EH sequence 
on Hewlett-Packard terminals cannot be used for home without losing 
some of the other features on the terminal.) 

If the terminal has row or column absolute-cursor addressing, these 
can be given as single parameter capabilities hpa (horizontal position 
absolute) and vpa (vertical position absolute). Sometimes these are 
shorter than the more general two-parameter sequence (as with the 
Hewlett-Packard 2645) and can be used in preference to cup. If there 
are parameterized local motions (e.g., move n spaces to the right) 
these can be given as cud, cub, cuf, and cuu with a single parameter 
indicating how many spaces to move. These are primarily useful if 
the terminal does not have cup, such as the Tektronix 4025. 



Section 1-4: Area Clears 

If the terminal can clear from the current position to the end of the 
line, leaving the cursor where it is, this should be given as el. If the 
terminal can clear from the beginning of the line to the current posi- 
tion inclusive, leaving the cursor where it is, this should be given as 
ell. If the terminal can clear from the current position to the end of 
the display, then this should be given as ed. ed is only defined from 
the first column of a line. (Thus, it can be simulated by a request to 
delete a large number of lines, if a true ed is not available.) 
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Section 1-5: Insert/Delete Line 

If the terminal can open a new blank line before the line where the 
cursor is, this should be given as ill; this is done only from the first 
position of a line. The cursor must then appear on the newly blank 
line. If the terminal can delete the line which the cursor is on, then 
this should be given as dll; this is done only from the first position on 
the line to be deleted. Versions of ill and dll which take a single 
parameter and insert or delete that many lines can be given as il and 
dl. 

If the terminal has a settable destructive scrolling region (like the 
VTIOO) the command to set this can be described with the csr capa- 
bility, which takes two parameters: the top and bottom lines of the 
scrolling region. The cursor position is, alas, undefined after using 
this command. It is possible to get the effect of insert or delete line 
using this command - the sc and rc (save and restore cursor) com- 
mands are also useful. Inserting lines at the top or bottom of the 
screen can also be done using ri or ind on many terminals without a 
true insert/delete line, and is often faster even on terminals with those 
features. 

To determine whether a terminal has destructive scrolling regions or 
non-destructive scrolling regions, create a scrolling region in the mid- 
dle of the screen, place data on the bottom line of the scrolling region, 
move the cursor to the top line of the scrolling region, and do a reverse 
index (ri) followed by a delete line (dll) or index (ind). If the data 
that was originally on the bottom line of the scrolling region was 
restored into the scrolling region by the dll or ind, then the terminal 
has non-destructive scrolling regions. Otherwise, it has destructive 
scrolling regions. Do not specify csr if the terminal has non- 
destructive scrolling regions, unless ind, ri, indn, rin, dl, and dll all 
simulate destructive scrolling. 

If the terminal has the ability to define a window as part of memory, 
which all commands affect, it should be given as the parameterized 
string wind. The four parameters are the starting and ending lines in 
memory and the starting and ending columns in memory, in that order. 

If the terminal can retain display memory above, then the da capabil- 
ity should be given; if display memory can be retained below, then db 
should be given. These indicate that deleting a line or scrolling a full 
screen may bring non-blank lines up from below or that scrolling back 
with ri may bring down non-blank lines. 



Section 1-6: Insert/Delete Character 

There are two basic kinds of intelligent terminals with respect to 
insert/delete character operations which can be described using - 
terminfo. The most common insert/delete character operations affect 
only the characters on the current line and shift characters off the end 
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of the line rigidly. Other terminals, such as the Concept 100 and the 
Perkin Elmer Owl, make a distinction between typed and untyped 
blanks on the screen, shifting upon an insert or delete only to an 
untyped blank on the screen which is either eliminated, or expanded to 
two untyped blanks. You can determine the kind of terminal you have 
by clearing the screen and then typing text separated by cursor 
motions. Type “abc def’ using local cursor motions (not spaces) 
between the abc and the def. Then position the cursor before the abc 
and put the terminal in insert mode. If typing characters causes the 
rest of the line to shift rigidly and characters to fall off the end, then 
your terminal does not distinguish between blanks and untyped posi- 
tions. If the abc shifts over to the def which then move together 
around the end of the current line and onto the next as you insert, you 
have the second type of terminal, and should give the capability in, 
which stands for “insert null”. W^ile these are two logically separate 
attributes (one line versus multiline insert mode, and special treatment 
of untyped spaces) no terminals whose insert mode cannot be 
described with the single attribute have been seen. 

terminfo can describe both terminals which have an insert mode and 
terminals which send a simple sequence to open a blank position on 
the current line. Give as smir the sequence to get into insert mode. 
Give as rmir the sequence to leave insert mode. Now give as ichl 
any sequence needed to be sent just before sending the character to be 
inserted. Most terminals with a true insert mode will not give ichl; 
terminals which send a sequence to open a screen position should give 
it here. (If your terminal has both, insert mode is usually preferable to 
ichl. Do not give both unless the terminal actually requires both to be 
used in combination.) If post-insert padding is needed, give this as a 
number of milliseconds padding in ip (a string option). Any other 
sequence which may need to be sent after an insert of a single charac- 
ter may also be given in ip. If your terminal needs both to be placed 
into an ‘insert mode’ and a special code to precede each inserted char- 
acter, then both smir/rmir and ichl can be given, and both will be 
used. The ich capability, with one parameter, «, will insert n blanks. 

If padding is necessary between characters typed while not in insert 
mode, give this as a number of milliseconds padding in rmp. 

It is occasionally necessary to move around while in insert mode to 
delete characters on the same line (e.g., if there is a tab after the inser- 
tion position). If your terminal allows motion while in insert mode 
you can give the capability mir to speed up inserting in this case. 
Omitting mir will affect only speed. Some terminals (notably 
Datamedia’s) must not have mir because of the way their insert mode 
works. 

Finally, you can specify dchl to delete a single character, dch with 
one parameter, n, to delete n characters, and delete mode by giving 
smdc and rmdc to enter and exit delete mode (any mode the terminal 
needs to be placed in for dchl to work). 
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A command to erase n characters (equivalent to outputting n blanks 
without moving the cursor) can be given as ech with one parameter. 



Section 1-7: Highlighting, Underlining, and Visible Bells 

Your terminal may have one or more kinds of display attributes that 
allow you to highlight selected characters when they appear on the 
screen. The following display modes (shown with the names by which 
they are set) may be available: a blinking screen (blink), bold or 
extra-bright characters (bold), dim or half-bright characters (dim), 
blanking or invisible text (invis), protected text (prot), a reverse- 
video screen (rev), and an alternate character set (smacs to enter this 
mode and rmacs to exit it). (If a command is necessary before you 
can enter alternate character set mode, give the sequence in enacs or 
“enable altemate-character-set’ ’ mode.) Turning on any of these 
modes singly may or may not turn off other modes. 

If you set any display attributes for highlighting, you will also want to 
provide the capability for turning them off. To do so, set sgrO. 

You should choose one , display method as standout mode [see 
€urses(S)] and use it to highlight error messages and other kinds of 
text to which you want to draw attention. Choose a form of display 
that provides strong contrast but that is easy on the eyes. (We recom- 
mend reverse- video plus half-bright or reverse- video alone.) The 
sequences to enter and exit standout mode are given as smso and 
rmso, respectively. If the code to change into or out of standout mode 
leaves one or even two blank spaces on the screen, as the TVI 912 and 
Teleray 1061 do, then xmc should be given to tell how many spaces 
are left. 

Codes to begin underlining and end underlining can be given as smul 
and rmul , respectively. If the terminal has a code to underline the 
current character and move the cursor one space to the right, such as 
the Micro-Term MIME, this can be given as uc. 

For historical reasons, some programs interpret rmso, rmul to mean 
"turn off all attributes," not just standout and underline, respectively. 

If there is a sequence to set arbitrary combinations of modes, this 
should be given as sgr (set attributes), taking nine parameters. Each 
parameter is either 0 or non-zero, as the corresponding attribute is on 
or off. The nine parameters are, in order: standout, underline, reverse, 
blink, dim, bold, blank, protect, alternate character set. Not all modes 
need to be supported by sgr; only those for which corresponding 
separate attribute commands exist should be supported. (See the 
example at the end of this section.) 

Terminals with the “magic cookie” glitch (xmc) deposit special 
“cookies” when they receive mode-setting sequences, which affect 
the display algorithm rather than having extra bits for each character. 
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Some terminals, such as the Hewlett-Packard 2621, automatically 
leave standout mode when they move to a new line or the cursor is 
addressed. Programs using standout mode should exit standout mode 
before moving the cursor or sending a newline, unless the msgr capa- 
bility, asserting that it is safe to move in standout mode, is present. 

If the terminal has a way of flashing the screen to indicate an error 
quietly (a bell replacement), then this can be given as flash; it must 
not move the cursor. A good flash can be done by changing the screen 
into reverse video, pad for 200 ms, then return the screen to normal 
video. 

If the cursor needs to be made more visible than normal when it is not 
on the bottom line (to make, for example, a non-blinking underline 
into an easier to find block or blinking underline) give this sequence as 
cvvis. The boolean chts should also be given. If there is a way to 
make the cursor completely invisible, give that as civis. The capabil- 
ity cnorm should be given which undoes the effects of either of these 
modes. 

If the terminal needs to be in a special mode when running a program 
that uses these capabilities, the codes to enter and exit this mode can 
be given as smcup and rmcup. This arises, for example, from termi- 
nals, such as the Concept, with more than one page of memory. If the 
terminal has only memory relative cursor addressing and not screen 
relative cursor addressing, a one screen-sized window must be fixed 
into the terminal for cursor addressing to work properly. This is also 
used for the Tektronix 4025, where smcup sets the command character 
to be the one used by terminfo. If the smcup sequence will not 
restore the screen after a rmcup sequence is output (to the state prior 
to outputting rmcup), specify nrrmc. 

If your terminal generates underlined characters by using the under- 
line character (with no special codes needed) even though it does not 
otherwise overs trike characters, then you should give the capability 
ul. For terminals where a character overstriking another leaves both 
characters on the screen, give the capability os. If overstrikes are 
erasable with a blank, then this should be indicated by giving eo. 

Example of highlighting: assume that the terminal under question 
needs the following escape sequences to turn on various modes. 

escape sequence 

\E[0m 
\E[0;4;7m 
\E[0;3m 
\E[0;4m 
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p4 


blink 


\E[0;5m 


p5 


dim 


\E[0;7m 


p6 


bold 


\E[0;3;4m 


P7 


invis 


\E[0;8m 


p8 


protect 


not available 


p9 


altcharset 


< 

o 

O 

< 



Note that each escape sequence requires a 0 to turn off other modes 
before turning on its own mode. Also note that, as suggested above, 
standout is set up to be the combination of reverse and dim. Also, 
because this terminal has no bold mode, bold is set up as the combina- 
tion of reverse and underline. In addition, to allow combinations, 
such as underline blink , the sequence to use would be \E[0;3;5m. 
The terminal doesn’t have protect mode, either, but that cannot be 
simulated in any way, so p8 is ignored. The altcharset mode is 
different in that it is either or depending on whether it is off or 
on. If all modes were to be turned on, the sequence would be 
\E[0;3;4;5;7;8m-N. 

Now look at when different sequences are output. For example, ;3 is 
output when either p2 or p6 is true, that is, if either underline or bold 
modes are turned on. Writing out the above sequences, along with 
their dependencies, gives the following: 



sequence 


when to output 


terminfo translation 


\E[0 


always 


\E[0 


;3 


if p2 or p6 


%?%p2%p6%l%t;3%; 


;4 


if pi or p3 or p6 


%?%pl %p3%l%p6%l%t;4%; 


;5 


if p4 


%?%p4%t;5%; 


;7 


if pi or p5 


%?%pl %p5%l%t;7%; 


;8 


ifp7 


%?%p7%t;8%; 


m 


always 


m 


^N or ''O 


if p9 ^N, else 


%?%p9%t - N%e - 0%; 



Putting this all together into the sgr sequence gives: 



sgr=\E[0%?%p2%p6%l%t;3%;%?%pl%p3%l%p6%l%t;4%;%?%p5%t;5%; 

%?%pl%p5%l%t;7%;%?%p7%t;8%;m%?%p9%t-N%e-0%;, 



Section 1-8: Keypad 

If the terminal has a keypad that transmits codes when the keys are 
pressed, this information can be given. Note that it is not possible to 
handle terminals where the keypad only works in local (this applies, 
for example, to the unshifted Hewlett-Packard 2621 keys). If the 
keypad can be set to transmit or not transmit, give these codes as 
smkx and rmkx. Otherwise the keypad is assumed to transmit. 

The codes sent by the left arrow, right arrow, up arrow, down arrow, 
and home keys can be given as kcubl, kcufl, kcuul, kcudl, and 
khome respectively. If there are function keys such as fO, fl, ..., f63. 
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the codes they send can be given as kfO, kfl, kf63. If the first 11 
keys have labels other than the default fO through flO, the labels can 
be given as IfO, Ifl, IflO. The codes transmitted by certain other 
special keys can be given: kll (home down), kbs (backspace), ktbc 
(clear all tabs), kctab (clear the tab stop in this column), kclr (clear 
screen or erase key), kdchl (delete character), kdll (delete line), 
krmir (exit insert mode), kel (clear to end of line), ked (clear to end 
of screen), kichl (insert character or enter insert mode), kill (insert 
line), knp (next page), kpp (previous page), kind (scroll 
forward/down), kri (scroll backward/up), khts (set a tab stop in this 
column). In addition, if the keypad has a 3 by 3 array of keys includ- 
ing the four arrow keys, the other five keys can be given as kal, ka3, 
kb2, kcl, and kc3. These keys are useful when the effects of a 3 by 3 
directional pad are needed. Further keys are defined above in the 
capabilities list. 

Strings to program function keys can be given as pfkey, pfloc, and 
pfx. A string to program their soft-screen labels can be given as pin. 
Each of these strings takes two parameters: the function key number 
to program (from 0 to 10) and the string to program it with. Function 
key numbers out of this range may program undefined keys in a 
terminal-dependent manner. The difference between the capabilities 
is that pfkey causes pressing the given key to be the same as the user 
typing the given string; pfloc causes the string to be executed by the 
terminal in local mode; and pfx causes the string to be transmitted to 
the computer. The capabilities nlab, Iw, and Ih define how many soft 
labels there are and their width and height. If there are commands to 
turn the labels on and off, give them in smln and rmln. smln is nor- 
mally output after one or more pin sequences to make sure that the 
change becomes visible. 



Section 1-9: Tabs and Initialization 

If the terminal has hardware tabs, the command to advance to the next 
tab stop can be given as ht (usually control I). A “backtab” command 
which moves leftward to the next tab stop can be given as cbt. By 
convention, if the teletype modes indicate that tabs are being 
expanded by the computer rather than being sent to the terminal, pro- 
grams should not use ht or cbt even if they are present, since the user 
may not have the tab stops properly set. If the terminal has hardware 
tabs which are initially set every n spaces when the terminal is 
powered up, the numeric parameter it is given, showing the number of 
spaces the tabs are set to. This is normally used by tput init [see 
tput{C)] to determine whether to set the mode for hardware tab expan- 
sion and whether to set the tab stops. If the terminal has tab stops that 
can be saved in nonvolatile memory, the terminfo description can 
assume that they are properly set. If there are commands to set and 
clear tab stops, they can be given as tbc (clear all tab stops) and fits 
(set a tab stop in the current column of every row). 
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Other capabilities include: isl, is2, and is3, initialization strings for 
the terminal; iprog, the path name of a program to be run to initialize 
the terminal; and if, the name of a file containing long initialization 
strings. These strings are expected to set the terminal into modes con- 
sistent with the rest of the terminfo description. They must be sent to 
the terminal each time the user logs in and be output in the following 
order: run the program iprog; output isl; output is2; set the margins 
using mgc, smgl, and smgr; set the tabs using tbc and hts; print the 
file if; and finally output is3. This is usually done using the init option 
of tput(C)\ see profile (F). 

Most initialization is done with is2. Special terminal modes can be 
set up without duplicating strings by putting the common sequences in 
is2 and special cases in isl and is3. Sequences that do a harder reset 
from a totally unknown state can be given as rsl, rs2, rf, and rs3, 
analogous to isl, is2, is3, and if. (The method using files, if and rf, is 
used for a few terminals, from lusrilibitabsetl * ; however, the recom- 
mended method is to use the initialization and reset strings.) These 
strings are output by tput reset, which is used when the terminal gets 
into a wedged state. Commands are normally placed in rsl, rs2, rs3, 
and rf only if they produce annoying effects on the screen and are not 
necessary when logging in. For example, the command to set a termi- 
nal into 80-column mode would normally be part of is2, but on some 
terminals it causes an annoying glitch on the screen and is not nor- 
mally needed since the terminal is usually already in 80-column 
mode. 

If a more complex sequence is needed to set the tabs than can be 
described by using tbc and hts, the sequence can be placed in is2 or if. 

Any margin can be cleared with mgc. (For instructions on how to 
specify commands to set and clear margins, see “Margins” below 
under “PRINTER CAPABILITIES.”) 



Section 1-10: Delays 

Certain capabilities control padding in the tty{l) driver. These are pri- 
marily needed by hard-copy terminals, and are used by tput init to set 
tty modes appropriately. Delays embedded in the capabilities cr, ind, 
cubl, ff, and tab can be used to set the appropriate delay bits to be set 
in the tty driver. If pb (padding baud rate) is given, these values can 
be ignored at baud rates below the value of pb. 



Section 1-11: Status Lines 

If the terminal has an extra “status line” that is not normally used by 
software, this fact can be indicated. If the status line is viewed as an 
extra line below the bottom line, into which one can cursor address 
normally (such as the Heathkit hl9’s 25th line, or the 24th line of a 
VTIOO which is set to a 23-line scrolling region), the capability hs 
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should be given. Special strings that go to a given column of the 
status line and return from the status line can be given as tsi and fsl. 
(fsl must leave the cursor position in the same place it was before tsl. 
If necessary, the sc and rc strings can be included in tsl and fsl to get 
this effect.) The capability tsl takes one parameter, which is the 
column number of the status line the cursor is to be moved to. 

If escape sequences and other special commands, such as tab, work 
while in the status line, the flag eslok can be given. A string which 
turns off the status line (or otherwise erases its contents) should be 
given as dsl. If the terminal has commands to save and restore the 
position of the cursor, give them as sc and rc. The status line is nor- 
mally assumed to be the same width as the rest of the screen, e.g., 
cols. If the status line is a different width (possibly because the termi- 
nal does not allow an entire line to be loaded) the width, in columns, 
can be indicated with the numeric parameter wsl. 



Section 1-12: Line Graphics 

If the terminal has a line drawing alternate character set, the mapping 
of glyph to character would be given in acsc. The definition of this 
string is based on the alternate character set used in the DEC VTIOO 
terminal, extended slightly with some characters from the AT&T 
4410vl terminal. 



glyph name 

arrow pointing right 
arrow pointing left 
arrow pointing down 
solid square block 
lantern symbol 
arrow pointing up 
diamond 

checker board (stipple) 
degree symbol 
plus/minus 
board of squares 
lower right comer 
upper right comer 
upper left comer 
lower left comer 
plus 

scan line 1 
horizontal line 
scan line 9 
left tee (|-) 



vtlOO+ 

character 

-I- 



6 

I 



a 

f 

g 

h 

j 

k 

1 

m 

n 

o 

q 

s 

t 
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right tee (-|) u 

bottom tee Q) v 

top tee ( J ) w 

vertical line x 

bullet 



The best way to describe a new terminaTs line graphics set is to add a 
third column to the above table with the characters for the new termi - 
nal that produce the appropriate glyph when the terminal is in the 
alternate character set mode. For example, 



glyph name 

upper left comer 
lower left comer 
upper right comer 
lower right comer 
horizontal line 
vertical line 



vtl00+ 

character 

1 

m 

k 

j 

q 

X 



new tty 
character 
R 
F 
T 
G 



Now write down the characters left to right, as in 
‘ ‘acsc=lRmFkTjGq\x.’ 

In addition, terminfo allows you to define multiple character sets. See 
Section 2-5 for details. 



Section 1-13: Color Manipulation 

There are two methods of color manipulation: the HP method and the 
Tektronix method. Most existing color terminals belong to one of 
these two classes. 

The Tektronix method uses a set of N predefined colors (usually 8) 
from which a user can select "current" foreground and background 
colors. Thus the terminal can support up to N colors mixed into N*N 
color-pairs to be displayed on the screen at the same time. 

The HP method restricts the user from defining the foreground 
independently of the background, or vice-versa. Instead, the user must 
define an entire color-pair at once. Up to M color-pairs, made from 
2*M different colors, can be defined this way. 

The numeric variables colors and pairs define the number of colors 
and color-pairs that can be displayed on the screen at the same time. 
If a terminal can change the definition of a color (as can, for example, 
the Tektronix 4100 and 4200 series terminals), this should be specified 
with ccc (can change color). To change the definition of a color (Tek- 
tronix method), use initc (initialize color). It requires four arguments: 
color number (ranging from 0 to colors- 1) and three RGB (red, green, 
and blue) values (ranging from 0 to 1,000). 
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Tektronix 4100 series terminals use a type of color notation called 
HLS (Hue Lightness Saturation) instead of RGB color notation. For 
such terminals one must define a boolean variable his. The last three 
arguments to the initc string would then be HLS values: H, ranging 
from 0 to 360; and L and S, ranging from 0 to 100. 

If a terminal can change the definitions of colors, but uses a color 
notation different from RGB and HLS, a mapping to either RGB or 
HLS must be developed. 

To set current foreground or background to a given color, use setff (set 
foreground) and setb (set background). They require one parameter: 
the number of the color. To initialize a color-pair (HP method), use 
initp (initialize pair). It requires seven parameters: the number of a 
color-pair (range = 0 to pairs- 1), and six RGB values: three for the 
foreground followed by three for the background. (Each of these 
groups of three should be in the order RGB.) When initc or initp are 
used, RGB or HLS arguments should be in the order "red, green, blue” 
or ’’hue, lightness, saturation”), respectively. To make a color-pair 
current, use scp (set color-pair). It takes one parameter, the number of 
a color-pair. 

Some terminals (for example, most color terminal emulators for PCs) 
erase areas of the screen with current background color. In such cases, 
bee (background color erase) should be defined. The variable op (ori- 
ginal pair) contains a sequence for setting the foreground and the 
background colors to what they were at the terminal start-up time. 
Similarly, oc (original colors) contains a control sequence for setting 
all colors (for the Tektronix method) or color-pairs (for the HP 
method) to the values they had at the terminal start-up time. 

Some color terminals substitute color for video attributes. Such video 
attributes should not be combined with colors. Information about 
these video attributes should be packed into the nev (no color video) 
variable. There is a one-to-one correspondence between the nine least 
significant bits of that variable and the video attributes. The follow- 
ing table depicts this correspondence. 



Attribute 



A.STANDOUT 

A^UNDERLINE 

A^REVERSE 

A3LINK 

A_DIM 

A_BOLD 

AJNVIS 

A_PROTECT 



NCV Bit 
Number 
0 
1 
2 

3 

4 

5 

6 
7 
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A^ALTCHARSET 8 

When a particular video attribute should not be used with colors, the 
corresponding ncv bit should be set to 1; otherwise it should be set to 
zero. For example, if the terminal uses colors to simulate reverse 
video and bold, bits 2 and 5 should be set to 1. The resulting values 
for ncv will be 22. 



Section 1-14: Miscellaneous 

If the terminal requires other than a null (zero) character as a pad, then 
this can be given as pad. Only the first character of the pad string is 
used. If the terminal does not have a pad character, specify npc. 

If the terminal can move up or down half a line, this can be indicated 
with hu (half-line up) and hd (half-line down). This is primarily use- 
ful for superscripts and subscripts on hardcopy terminals. If a hard- 
copy terminal can eject to the next page (form feed), give this as ff 
(usually control L). 

If there is a command to repeat a given character a given number of 
times (to save time transmitting a large number of identical charac- 
ters) this can be indicated with the parameterized string rep. The first 
parameter is the character to be repeated and the second is the number 
of times to repeat it. Thus, tparm(repeat_char, ’x’, 10) is the same as 
xxxxxxxxxx. 

If the terminal has a settable command character, such as the Tek- 
tronix 4025, this can be indicated with cmdch. A prototype command 
character is chosen which is used in all capabilities. This character is 
given in the cmdch capability to identify it. The following conven- 
tion is supported on some UNIX systems: If the environment variable 
CC exists, all occurrences of the prototype character are replaced with 
the character in CC. 

Terminal descriptions that do not represent a specific kind of known 
terminal, such as switch, dialup, patch, and network, should include 
the gn (generic) capability so that programs can complain that they do 
not know how to talk to the terminal. (This capability does not apply 
to virtual terminal descriptions for which the escape sequences are 
known.) If the terminal is one of those supported by the UNIX system 
virtual terminal protocol, the terminal number can be given as vt. A 
line-tum-around sequence to be transmitted before doing reads shouM 
be specified in rfi. 

If the terminal uses xon/xofif handshaking for flow control, give xon. 
Padding information should still be included so that routines can make 
better decisions about costs, but actual pad characters will not be 
transmitted. Sequences to turn on and off xon/xoff handshaking may 
be given in smxon and rmxon. If the characters used for handshaking 
are not and ^Q, they may be specified with xonc and xoffc. 
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If the terminal has a “meta key” which acts as a shift key, setting the 
8th bit of any character transmitted, this fact can be indicated with 
km. Otherwise, software will assume that the 8th bit is parity and it 
will usually be cleared. If strings exist to turn this “meta mode” on 
and off, they can be given as smm and rmm. 

If the terminal has more lines of memory than will fit on the screen at 
once, the number of lines of memory can be indicated with Im. A 
value of lm#0 indicates that the number of lines is not fixed, but that 
there is still more memory than fits on the screen. 

Media copy strings which control an auxiliary printer connected to the 
terminal can be given as mcO: print the contents of the screen, mc4: 
turn off the printer, and mc5: turn on the printer. When the printer is 
on, all text sent to the terminal will be sent to the printer. A variation, 
mc5p, takes one parameter, and leaves the printer on for as many 
characters as the value of the parameter, then turns the printer off. The 
parameter should not exceed 255. If the text is not displayed on the 
terminal screen when the printer is on, specify mc5i (silent printer). 
All text, including mc4, is transparently passed to the printer while an 
mc5p is in effect. 



Section 1-15: Special Cases 

The working model used by terminfo fits most terminals reasonably 
well. However, some terminals do not completely match that model, 
requiring special support by terminfo . These are not to be construed 
as deficiencies in the terminals; they are just differences between the 
working model and the actual hardware. They may be unusual de- 
vices or, for some reason, do not have all the features of the terminfo 
model implemented. 

Terminals which can not display tilde (~) characters, such as certain 
Hazeltine terminals, should indicate hz. 

Terminals which ignore a linefeed immediately after an am wrap, 
such as the Concept 100, should indicate xenl. Those terminals whose 
cursor remains on the right-most column until another character has 
been received, rather than wrapping immediately upon receiving the 
right-most character, such as the VTKX), should also indicate xenl. 

If el is required to get rid of standout (instead of writing normal text 
on top of it), xhp should be given. 

Those Teleray terminals whose tabs turn all characters moved over to 
blanks, should indicate xt (destructive tabs). This capability is also 
taken to mean that it is not possible to position the cursor on top of a 
“magic cookie” therefore, to erase standout mode, it is instead neces- 
sary to use delete and insert line. 
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Those Beehive Superbee terminals which do not transmit the escape 
or control-C characters, should specify xsb, indicating that the fl key 
is to be used for escape and the f2 key for control-C. 



Section 1-16: Similar Terminals 

If there are two very similar terminals, one can be defined as being 
just like the other with certain exceptions. The string capability use 
can be given with the name of the similar terminal. The capabilities 
given before use override those in the terminal type invoked by use. 
A capability can be canceled by placing xx@ to the left of the capabil- 
ity definition, where xx is the capability. For example, the entry 

att4424-2 {Teletype 4424 in display function group ii, 
rev0, sgr0, srnul0, use=att4424, 

defines an AT&T 4424 terminal that does not have the rev, sgr, and 
smul capabilities, and hence cannot do highlighting. This is useful for 
different modes for a terminal, or for different user preferences. More 
than one use capability may be given. 



PART 2: PRINTER CAPABILITIES 

The terminfo database allows you to define capabilities of printers as 
well as terminals. To find out what capabilities are available for 
printers as well as for terminals, see the two lists under "TERMINAL 
CAPABILITIES" that list capabilities by variable and by capability 
name. 



Section 2-1: Rounding Values 

Because parameterized string capabilities work only with integer 
values, we recommend that terminfo designers create strings that 
expect numeric values that have been rounded. Application designers 
should note this and should always round values to the nearest integer 
before using them with a parameterized string capability. 



Section 2-2: Printer Resolution 

A printer’s resolution is defined to be the smallest spacing of charac- 
ters it can achieve. In general printers have independent resolution 
horizontally and vertically. Thus the vertical resolution of a printer 
can be determined by measuring the smallest achievable distance 
between consecutive printing baselines, while the horizontal resolu- 
tion can be determined by measuring the smallest achievable distance 
between the left-most edges of consecutive printed, identical, charac- 
ters. 
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All printers are assumed to be capable of printing with a uniform hor- 
izontal and vertical resolution. The view of printing that the terminfo 
currently presents is one of printing inside a uniform matrix: All char- 
acters are printed at fixed positions relative to each “cell” in the 
matrix; furAermore, each cell has the same size given by the smallest 
horizontal and vertical step sizes dictated by the resolution. (The cell 
size can be changed as will be seen later.) 

Many printers are capable of “proportional printing,” where the hor- 
izontal spacing depends on the size of the character last printed. The - 
terminfo does not make use of this capability, although it does provide 
enough capability definitions to allow an application to simulate pro- 
portional printing. 

A printer must not only be able to print characters as close together as 
the horizontal and vertical resolutions suggest, but also of “moving” 
to a position an integral multiple of the smdlest distance away from a 
previous position. Thus printed characters can be spaced apart a dis- 
tance that is an integral multiple of the smallest distance, up to the 
length or width of a single page. 

Some printers can have different resolutions depending on different 
“modes.” In “normal mode,” the existing terminfo capabilities are 
assumed to work on columns and lines, just like a video terminal. 
Thus the old lines capability would give the length of a page in lines, 
and the cols capability would give the width of a page in columns. In 
“micro mode,” many termitrfo capabilities work on increments of 
lines and columns. With some printers the micro mode may be con- 
comitant with normal mode, so that all the capabilities work at the 
same time. 



Section 2-3: Specifying Printer Resolution 

The printing resolution of a printer is given in several ways. Each 
specifies the resolution as the number of smallest steps per distance: 

Specification of Printer Resolution 
Characteristic Number of Smallest Steps 

orhi Steps per inch horizontally 

orvi Steps per inch vertically 

ore Steps per column 

orl Steps per line 

When printing in normal mode, each character printed causes move- 
ment to the next column, except in special cases described later; the 
distance moved is the same as the per-column resolution. Some 
printers cause an automatic movement to the next line when a charac- 
ter is printed in the rightmost position; the distance moved vertically 
is the same as the per-line resolution. When printing in micro mode, 
these distances can be different, and may be zero for some printers. 
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Specification of Printer Resolution 
Automatic Motion after Printing 

Normal Mode: 

ore Steps moved horizontally 

orl Steps moved vertically 

Micro Mode : 

mes Steps moved horizontally 

mis Steps moved vertically 

Some printers are capable of printing wide characters. The distance 
moved when a wide character is printed in normal mode may be 
different from when a regular width character is printed. The distance 
moved when a wide character is printed in micro mode may also be 
different from when a regular character is printed in micro mode, but 
the differences are assumed to be related: If the distance moved for a 
regular character is the same whether in normal mode or micro mode 
(mcs=orc), then the distance moved for a wide character is also the 
same whether in normal mode or micro mode. This doesn’t mean the 
normal character distance is necessarily the same as the wide charac- 
ter distance, just that the distances don’t change with a change in nor- 
mal to micro mode. However, if the distance moved for a regular 
character is different in micro mode from the distance moved in nor- 
mal mode (mcs<orc), the micro mode distance is assumed to be the 
same for a wide character printed in micro mode, as the table below 
shows. 



Specification of Printer Resolution 
Automatic Motion after Printing Wide Character 

Normal Mode or Micro Mode (mes = ore); 
widcs Steps moved horizontally 

Micro Mode (mes < ore); 

mes Steps moved horizontally 

There may be control sequences to change the number of columns per 
inch (the character pitch) and to change the number of lines per inch 
(the line pitch). If these are used, the resolution of the printer changes, 
but the type of change depends on the printer: 

Specification of Printer Resolution 
Changing the Character/Line Pitches 

cpi Change character pitch 

cpix If set, cpi changes orhi, otherwise changes ore 

Ipi Change line pitch 

Ipix If set, Ipi changes orvi, otherwise changes orl 

chr Change steps per column 
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cvr Change steps per line 

The cpi and Ipi string capabilities are each used with a single argu- 
ment, the pitch in columns (or characters) and lines per inch, respec- 
tively. The chr and cvr string capabilities are each used with a single 
argument, the number of steps per column and line, respectively. 

Using any of the control sequences in these strings will imply a 
change in some of the values of ore, orhi, orl, and orvi. Also, the dis- 
tance moved when a wide character is printed, widcs, changes in rela- 
tion to ore. The distance moved when a character is print^ in micro 
mode, mes, changes similarly, with one exception: if the distance is 0 
or 1, then no change is assumed (see item marked with t in the follow- 
ing table). 

Programs that use cpi, Ipi, chr, or cvr should recalculate the printer 
resolution (and should recalculate other values — see “Section 2-7: 
Effect of Changing Printing Resolution”). 



Specification of Printer Resolution 
Effects of Changing the Character/Line Pitches 



Before 


After 


Using cpi with cpix clear: 
orhi ’ 


orhi 


ore ’ 


orhi 

orc= 


Using cpi with cpix set: 
orhi ’ 


^ cpi 

orhi=orc'V cpi 


ore ’ 


ore 


Using Ipi with Ipix clear: 
orvi ’ 


orvi 


orr 


, orvi 
orl- _ 


Using Ipi with Ipix set: 
orvi ’ 


^ Ipi 

orvi=orlU/«; 


orl’ 


orl 


Using chr: 
orhi ’ 


orhi 


ore ’ 


Vchr 


Using cvr: 
orvi ’ 


orvi 


orl’ 




Using cpi or chr: 
widcs ’ 


widcs = widcs 


mes ’ t 


ore 
. ore 

mcs=mcs 

ore 
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^ cpi^ ^ipiy Vchry ^nd the arguments used with cpi, Ipi, chr, 

and cvr respectively. The t mark indicates the old value. 



Section 2-4: Capabilities that Cause Movement 

In the following descriptions, “movement” refers to the motion of the 
“current position.” With video terminals this would be the cursor; 
with some printers this is the carriage position. Other printers have 
different equivalents. In general, the current position is where a char- 
acter would be displayed if printed. 

terminfo has string capabilities for control sequences that cause move- 
ment a number of full columns or lines. It also has equivalent string 
capabilities for control sequences that cause movement a number of 
smallest steps. 



String Capabilities for Motion 



mcubl 


Move 1 step left 


mcufl 


Move 1 step right 


mcuul 


Move 1 step up 


mcudl 


Move 1 step down 


mcub 


Move N steps left 


mcuf 


Move N steps right 


mcuu 


Move N steps up 


mcud 


Move N steps down 


mhpa 


Move N steps from the left 


mvpa 


Move N steps from the top 



The latter six strings are each used with a single argument, N. 

Sometimes the motion is limited to less than the width or length of a 
page. Also, some printers don’t accept absolute motion to the left of 
the current position, terminfo has capabilities for specifying these 
limits. 



Limits to Motion 

mjump Limit on use of mcubl, mcufl, mcuul, mcudl 
maddr Limit on use of mhpa, mvpa 

xhpa If set, hpa and mhpa can’t move left 

xvpa If set, vpa and mvpa can’t move up 

If a printer needs to be in a “micro mode” for the motion capabilities 
described above to work, there are string capabilities defined to con- 
tain the control sequence to enter and exit this mode. A boolean is 
available for those printers where using a carriage return causes an 
automatic return to normal mode. 
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Entering/Exiting Micro Mode 

smicm Enter micro mode 
rmicm Exit micro mode 

crxm Using cr exits micro mode 

The movement made when a character is printed in the rightmost posi- 
tion varies among printers. Some make no movement, some move to 
the beginning of the next line, others move to the beginning of the 
same line, terminfo has boolean capabilities for describing all three 
cases. 



What Happens After Character 
Printed in Rightmost Position 

sam Automatic move to beginning of same line 

Some printers can be put in a mode where the normal direction of 
motion is reversed. This mode can be especially useful when there 
exists no capabilities for leftward or upward motion, because those 
capabilities can be built from the motion reversal capability and the 
rightward or downward motion capabilities. It is best to leave it up to 
an application to build the leftward or upward capabilities, though, 
and not enter them in the terminfo database. This allows several 
reverse motions to be strung together without intervening wasted steps 
that leave and reenter reverse mode. 

Entering/Exiting Reverse Modes 

slm Reverse sense of horizontal motions 
rim Restore sense of horizontal motions 
sum Reverse sense of vertical motions 

rum Restore sense of vertical motions 

While sense of horizontal motions reversed: 

mcubl Move 1 step right 

mcuH Move 1 step left 

mcub Move N steps right 

mcuf Move N steps left 

cubl Move 1 column right 

cufl Move 1 column left 

cub Move N columns right 

cuf Move N columns left 

While sense of vertical motions reversed: 
mcuul Move 1 step down 

mcudl Move 1 step up 

mcuu Move N steps down 

mcud Move N steps up 

cuul Move 1 line down 

cudl Move 1 line up 
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cuu Move N lines down 

cud Move N lines up 

The reverse motion modes should not affect the mvpa and mhpa abso- 
lute motion capabilities. The reverse vertical motion mode should, 
however, also reverse the action of the line “wrapping” that occurs 
when a character is printed in the right-most position. Thus printers 
that have the standard terminfo capability am defined should experi- 
ence motion to the beginning of the previous line when a character is 
printed in the right-most position under reverse vertical motion mode. 

The action when any other motion capabilities are used in reverse 
motion modes is not defined; thus, programs must exit reverse motion 
modes before using other motion capabilities. 

Two miscellaneous capabilities complete the list of new motion capa- 
bilities. One of these is needed for printers that move the current posi- 
tion to the beginning of a line when certain control characters, like 
“line-feed’ ’ or “form- feed,” are used. The other is used for the capa- 
bility of suspending the motion that normally occurs after printing a 
character. 



Miscellaneous Motion Strings 

doer List of control characters causing cr 

zerom Prevent auto motion after printing next single character 



Margins 

terminfo provides two strings for setting margins on terminals: one 
for the left and one for the right margin. Printers, however, have two 
additional margins, for the top and bottom margins of each page. 
Furthermore, some printers do not require using motion strings to 
move the current position to a margin and fixing the margin there, as 
with the existing capabilities, but require the specification of where a 
margin should be regardless of the current position. Therefore 
terminfo offers six additional strings for defining margins with 
printers. 



Setting Margins 

smgl Set left margin at current column 
smgr Set right margin at current column 

smgb Set soft bottom margin at current line 
smgt Set soft top margin at current line 

smgbp Set soft bottom margin at line N 
smglp Set soft left margin at column N 
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smgrp Set soft right margin at column N 
smgtp Set soft top margin at line N 

The last four strings are used with a single argument, Ny that gives the 
line or column number, where line 0 is the top line and column 0 is the 
left most column. Note: Not all printers use 0 for the top line or the 
left-most column. 

All margins can be cleared with mgc. 



Shadows, Italics, Wide Characters, Superscripts, Subscripts 

Five new sets of strings are used to describe the capabilities printers 
have of enhancing printed text. 

Enhanced Printing 

sshm Enter shadow-printing mode 
rshm Exit shadow-printing mode 

sitm Enter italicizing mode 

ritm Exit italicizing mode 

swidm Enter wide character mode 

rwidm Exit wide character mode 

ssupm Enter superscript mode 

rsupm Exit superscript mode 

supcs List of characters available as superscripts 

ssubm Enter subscript mode 

rsubm Exit subscript mode 

subcs List of characters available as subscripts 

If a printer requires the sshm control sequence before every character 
to be shadow-printed, the rshm string is left blank. Thus programs 
that find a control sequence in sshm but none in rshm should use the 
sshm control sequence before every character to be shadow-printed; 
otherwise, the sshm control sequence should be used once before the 
set of characters to be shadow-printed, followed by rshm. The same 
is also true of each of the sitm/ritm, swidm/rwidm, ssupm/rsupm, 
and ssubm/rsubm pairs. 

Note that terminfo also has a capability for printing emboldened text 
(bold). While shadow printing and emboldened printing are similar in 
that they “darken” the text, many printers produce these two types of 
print in slightly different ways. Generally, emboldened printing is 
done by overstriking the same character one or more times. Shadow 
printing likewise usually involves overstriking, but with a slight 
movement up and/or to the side so that the character is “fatter.” 

It is assumed that enhanced printing modes are independent modes, so 
that it would be possible, for instance, to shadow print italicized sub- 
scripts. 
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As mentioned earlier, the amount of motion automatically made after 
printing a wide character should be given in widcs. 

If only a subset of the printable ASCII characters can be printed as 
superscripts or subscripts, they should be listed in supcs or subcs 
strings, respectively. If the ssupm or ssubm strings contain control 
sequences, but the corresponding supcs or subcs strings are empty, it 
is assumed that all printable ASCII characters are available as super- 
scripts or subscripts. 

Automatic motion made after printing a superscript or subscript is 
assumed to be the same as for regular characters. Thus, for example, 
printing any of the following three examples will result in equivalent 
motion: 

Bi B. B' 

1 

Note that the existing msgr boolean capability describes whether 
motion control sequences can be used while in “standout mode.” 
This capability is extended to cover the enhanced printing modes 
added here, msgr should be set for those printers that accept any 
motion control sequences without affecting shadow, italicized, 
widened, superscript, or subscript printing. Conversely, if msgr is not 
set, a program should end these modes before attempting any motion. 



Section 2-5: Alternate Character Sets 

In addition to allowing you to define line graphics (described in Sec- 
tion 1-12), terminfo also lets you define alternate character sets. The 
following capabilities cover printers and terminals with multiple 
selectable or definable character sets. 

Alternate Character Sets 
scs Select character set N 

scsd Start definition of character set N, M characters 
defc Define character A, B dots wide, descender D 
rcsd End definition of character set N 
csnm List of character set names 
daisy Printer has manually changed print-wheels 

The scs, rcsd, and csnm strings are used with a single argument, A, a 
number from 0 to 63 that identifies the character set. The scsd string 
is also used with the argument N and another, M, that gives the num- 
ber of characters in the set. The defc string is used with three argu- 
ments: A gives the ASCII code representation for the character, B 
gives the width of the character in dots, and D is zero or one depend- 
ing on whether the character is a “descender” or not. The defc string 
is also followed by a string of “image-data” bytes that describe how 
the character looks (see below). 
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Character set 0 is the default character set present after the printer has 
been initialized. Not every printer has 64 character sets, of course; 
using scs with an argument that doesn’t select an available character 
set should cause a null result from tparm ( ). 

If a character set has to be defined before it can be used, the scsd con- 
trol sequence is to be used before defining the character set, and the 
rcsd is to be used after. They should also cause a null result from 
tparm( ) when used with an argument N that doesn’t apply. If a char- 
acter set still has to be select^ after being defined, the scs control 
sequence should follow the rcsd control sequence. By examining the 
results of using each of the scs, scsd, and rcsd strings with a character 
set number in a call to tparm { ), a program can determine which of the 
three are needed. 

Between use of the scsd and rcsd strings, the defc string should be 
used to define each character. To print any character on printers 
covered by terminfo , the ASCII code is sent to the printer. This is true 
for characters in an alternate set as well as “normal” characters. 
Thus the definition of a character includes the ASCII code that 
represents it. In addition, the width of the character in dots is given, 
along with an indication of whether the character should descend 
below the print line (like the lower case letter “g” in most character 
sets). The width of the character in dots also indicates the number of 
image-data bytes that will follow the defc string. These image-data 
bytes indicate where in a dot-matrix pattern ink should be applied to 
“draw” the character; the number of these bytes and their form are 
defined below under "Dot-Mapped Graphics". 

It’s easiest for the creator of terminfo entries to refer to each character 
set by number; however, these numbers will be meaningless to the 
application developer. The csnm string alleviates this problem by 
providing names for each number. 

When used with a character set number in a call to tparm ( ), the csnm 
string will produce the equivalent name. These names should be used 
as a reference only. No naming convention is implied, although any- 
one who creates a terminfo entry for a printer should use names con- 
sistent with the names found in user documents for the printer. Appli- 
cation developers should allow a user to specify a character set by 
number (leaving it up to the user to examine the csnm string to deter- 
mine the correct number), or by name, where the application examines 
the csnm string to determine the corresponding character set number. 

These capabilities are likely to be used only with dot-matrix printers. 
If they are not available, the strings should not be defined. For printers 
that have manually changed print-wheels or font cartridges, the 
boolean daisy is set. 
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Section 2-6: Dot-Matrix Graphics 



Dot-matrix printers typically have the capability of reproducing 
“raster-graphics” images. Three new numeric capabilities and three 
new string capabilities can help a program draw raster-graphics 
images independent of the type of dot-matrix printer or the number of 
pins or dots the printer can handle at one time. 



Dot-Matrix Graphics 

npins Number of pins, iV, in print-head 
spiny Spacing of pins verticdly in pins per inch 
spinh Spacing of dots horizontally in dots per inch 
porder Matches software bits to print-head pins 
shim Start printing bit image graphics, B bits wide 
rbim End printing bit image graphics 

The shim sring is used with a single argument, B, the width of the 
image in dots. 



The model of dot-matrix or raster-graphics that the tenninfo presents 
is similar to the technique used for most dot-matrix printers: Each 
pass of the printer’s print-head is assumed to produce a dot-matrix that 
is N dots high and B dots wide. This is typic^ly a wide, squat, rectan- 
gle of dots. The height of this rectangle in dots will vary from one 
printer to the next; this is given in the npins numeric capability. The 
size of the rectangle in fractions of an inch will also vary; it can be 
deduced from the spinv and spinh numeric capabilities. With these 
three values an application can divide a complete raster-graphics 
image into several horizontal strips, perhaps interpolating to account 
for different dot spacing vertically and horizontally. 

The shim and rbim strings are used to start and end a dot-matrix 
image, respectively. The sbim string is used with a single argument 
that gives the width of the dot-matrix in dots. A sequence of “image- 
data bytes” are sent to the printer after the sbim string and before the 
rbim string. The number of bytes is an integral multiple of the width 
of the dot-matrix; the multiple and the form of each byte is determined 
by the porder string as described below. 



The porder string is a comma separated list of pin numbers; the posi- 
tion of each pin number in the list corresponds to a bit in a data byte. 
The pins are numbered consecutively from 1 to npins, with 1 being 
the top pin. Note that the term “pin” is used loosely here; “ink-jet” 
dot-matrix printers don’t have pins, but can be considered to have an 
equivalent method of applying a single dot of ink to paper. The bit 
positions in porder are in groups of 8, with the first position in each 
group the most significant bit and the last position the least significant 
bit. 
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The “image-data bytes” are to be computed from the dot-matrix 
image, mapping vertical dot positions in each print-head pass into 
eight-bit bytes, using a 1 bit where ink should be applied and 0 where 
no ink should be applied. If a position is skipped in porder, a 0 bit is 
used. There must be a multiple of 8 bit positions used or skipped in 
porder; if not, 0 bits are us^ to fill the last byte in the least signifi- 
cant bits. 



Section 2-7: Effect of Changing Printing Resolution 



If the control sequences to change the character pitch or the line pitch 
are used, the pin or dot spacing may change: 

Dot-Matrix Graphics 
Changing the Character/Line Pitches 

cpi Change character pitch 

cpix If set, cpi changes spinh 

Ipi Change line pitch 

Ipix If set, Ipi changes spinv 

Programs that use cpi or Ipi should recalculate the dot spacing: 

Dot-Matrix Graphics 

Effects of Changing the Character/Line Pitches 
Before After 

Using cpi with cpix clear: 
spinh ’ spinh 



Using cpi with cpix set: 
spinh ’ 



spinh =spinh 



, orhi 
orhi' 



Using Ipi with Ipix clear: 
spinv ’ spinv 



Using Ipi with Ipix set: 
spinv ’ 

Using chr: 
spinh ’ 



. . , orhi 

spinv=spinv • — 777 
orhi 



spinh 



Using cvr: 

spinv ’ spinv 



orhi’ and orhi are the values of the horizontal resolution in steps per 

inch, before using cpi and after using cpi, respectively. Likewise, 

orvi’ and orvi are the values of the vertical resolution in steps per 

inch, before using Ipi and after using Ipi, respectively. Thus, the 

changes in the dots per inch for dot-matrix graphics follow the 
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changes in steps per inch for printer resolution. 



Section 2-8: Print Quality 

Many dot-matrix printers can alter the dot spacing of printed text to 
produce near “letter quality’’ printing or “draft quality’’ printing. 
Usually it is important to be able to choose one or the other because 
the rate of printing generally falls off as the quality improves. There 
are three new strings used to describe these capabilities. 

Print Quality 

snlq Set near-letter quality print 

snrmq Set normal quality print 

sdrfq Set draft quality print 

The capabilities are listed in decreasing levels of quality. If a printer 
doesn’t have all three levels, one or two of the strings should be left 
blank as appropriate. 



Section 2-9: Printing Rate and Buffer Size 

Because there is no standard protocol that can be used to keep a pro- 
gram synchronized with a printer, and because modem printers can 
buffer data before printing it, a program generally cannot determine at 
any time what has been printed. Two new numeric capabilities can 
help a program estimate what has been printed. 

Print Rate/Buffer Size 

cps Nominal print rate in characters per second 
bufsz Buffer capacity in characters 

cps is the nominal or average rate at which the printer prints charac- 
ters; if this value is not given, the rate should be estimated at one- 
tenth the prevailing baud rate, bufsz is the maximum number of sub- 
sequent characters buffered before the guaranteed printing of an ear- 
lier character, assuming proper flow control has been used. If this 
value is not given it is assumed that the printer does not buffer charac- 
ters, but prints them as they are received. 

As an example, if a printer has a 1000-character buffer, then sending 
the letter “a’’ followed by 1000 additional characters is guaranteed to 
cause the letter “a’’ to print. If the same printer prints at the rate of 
100 characters per second, then it should take 10 seconds to print all 
the characters in the buffer, less if the buffer is not full. By keeping 
track of the characters sent to a printer, and knowing the print rate and 
buffer size, a program can synchronize itself with the printer. 
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Note that most printer manufacturers advertise the maximum print 
rate, not the nominal print rate. A good way to get a value to put in for 
cps is to generate a few pages of text, count the number of printable 
characters, then see how long it takes to print the text. 

Applications that use these values should recognize the variability in 
the print rate. Straight text, in short lines, with no embedded control 
sequences will probably print at close to the advertised print rate and 
probably faster than the rate in cps. Graphics data with a lot of con- 
trol sequences, or very long lines of text, will print at well below the 
advertised rate and below the rate in cps. If the application is using 
cps to decide how long it should take a printer to print a block of text, 
the application should pad the estimate. If the application is using cps 
to decide how much text has already been print^, it should shrink the 
estimate. The application will thus err in favor of the user, who wants, 
above all, to see ^1 the output in its correct place. 



Files 


/usr/lib/terminfo/? /* 
/usr/lib/.COREterm/?/* 

/usrAib/tabset/* 


compiled terminal description database 
subset of compiled terminal description 
database 

tab settings for some terminals, in a for- 
mat appropriate to be output to the ter- 
minal (escape sequences that set mar- 
gins and tabs) 


See Also 




tput(C), vi(C), captoinfo(ADM), infocmp(ADM), tic(C), term(M), 
curses(S), printf(S), profile(F), terminfo(F) 


Warning 




As described in the 


"Tabs and Initialization " section above, a 



terminal’s initialization strings, isl, is2, and is3, if defined, must be 
output before a curses (S) program is run. An available mechanism for 
outputting such strings is tput init [see tput(C) and profile(F)]. 

If a null character (NO) is encountered in a string, the null and all char- 
acters after it are lost. Therefore it is not possible to code a null char- 
acter (NO) and send it to a device (either terminal or printer). The 
suggestion of sending aN0200, where aM) (null) is needed can succeed 
only if the device (terminal or printer) ignores the eighth bit. For 
example, because all eight bits are used in the standard international 
ASCII character set, devices that adhere to this standard will treat 
N0200 differently fromN3. 
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Tampering with entries in /usr/libf .COREterml?!* or 

lusrlliblterminfo/? I* (for example, changing or removing an entry) can 
affect programs such as v/(C) that expect the entry to be present and 
correct. In particular, removing the description for the ’’dumb" termi- 
nal will cause unexpected problems. 
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termio 

general terminal interface 

Description 



All asynchronous communications ports use the same general inter- 
face, no matter what hardware is involved. The remainder of this sec- 
tion discusses the common features of this interface. 

When a terminal file is opened, it normally causes the process to wait 
until a connection is established. In practice, users’ programs seldom 
open these files; they are opened by getty(}A) and become a user’s 
standard input, output, and error files. The very first terminal file 
opened by the process group leader of a terminal file not already asso- 
ciated with a process group becomes the “control terminal” for that 
process group. The control terminal plays a special role in handling 
quit and interrupt signals, as discussed below. The control terminal is 
inherited by a child process during ?i fork{S). A process can break this 
association by changing its process group using setpgrp(S). 

A terminal associated with one of these files ordinarily operates in 
full-duplex mode. Characters can be entered at any time, even while 
output is occurring, and are only lost when the system’s character 
input buffers become completely full, which is rare, or when the user 
has accumulated the maximum allowed number of input characters 
that have not yet been read by some program. Currently, this limit is 
256 characters. When the input limit is reached, all the saved charac- 
ters are thrown away without notice. 

Normally, terminal input is processed in units of lines. A line is 
delimited by a newline (ASCII LF) character, an end-of-file (ASCII 
EOT) character, or an end-of-line character. This means that a pro- 
gram attempting to read will be suspended until an entire line has 
been entered. Also, no matter how many characters are requested in 
the read call, one line will be returned at most. It is not, however, 
necessary to read a whole line at once; any number of characters may 
be requested in a read, even one, without losing information. 

Erase and kill processing is normally done during input. By default, a 
Ctrl-H or BACKSPACE erases the last character typed, except that it 
will not erase beyond the beginning of the line. By default, a Ctrl-U 
kills (deletes) the entire input line, and optionally outputs a newline 
character. Both these characters operate on a key-stroke basis, 
independent of any backspacing or tabbing that may have been done. 
Both the erase and kill characters may be entered literally by preced- 
ing them with the escape character (\). In this case, the escape charac- 
ter is not read. The erase and kill characters may be changed (see 
stty(C)). 
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Certain characters have special functions on input. These functions 

and their default character values are summarized as follows: 

INTR (Rubout or ASCII DEL) Generates an interrupt signal which 
is sent to all processes with the associated control terminal. 
Normally, each such process is forced to terminate, but 
arrangements may be made either to ignore the signal or to 
receive a trap to an agreed-upon location; see signal(S), 

QUIT (Ctrl-\ or ASCII FS) Generates a quit signal. Its treatment is 
identical to the interrupt signal except that, unless a receiv- 
ing process has made other arrangements, it will not only be 
terminated, but a core image file (called core) will be 
created in the current working directory. 

SWTCH (ASCII NUL) Is used by the job control facility, shl{C), to 
change the current layer to the control layer. 

ERASE (Ctrl-H) Erases the preceding character. It will not erase 
beyond the start of a line, as delimited by a NL, EOF, or EOL 
character. 

KILL (Ctrl-U) Deletes the entire line, as delimited by a NL, EOF, or 
EOL character. 

EOF (Ctrl-D or ASCII EOT) May be used to generate an end-of-file 
from a terminal. When received, all the characters waiting 
to be read are immediately passed to the program, without 
waiting for a newline, and the EOF is discarded. Thus, if 
there are no characters waiting, which is to say the EOF 
occurred at the beginning of a line, zero characters will be 
passed back, which is the standard end-of-file indication. 

NL (ASCII LF) Is the normal line delimiter. It cannot be changed 
or escaped. 

EOL (ASCII NUL) Is an additional line delimiter, like NL. It is not 
normally used. 

STOP (Ctrl-S or ASCII DC3) Temporarily suspends output. It is use- 
ful with CRT terminals to prevent output from disappearing 
before it can be read. While output is suspended, STOP char- 
acters are ignored and not read. 

START (Ctrl-Q or ASCII DCl) Resumes output which has been 
suspended by a STOP character. While output is not 
suspended, START characters are ignored and not read. The 
START/STOP characters cannot be changed or escaped. 

The character values for INTR, QUIT, SWTCH, ERASE, KILL, EOF, and 

EOL may be changed to suit individual tastes. The ERASE, KILL, and 

EOF characters may be escaped by a preceding backslash (\) character. 
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in which case no special function is carried out. 

When the carrier signal from the dataset drops, a “hangup” signal is 
sent to all processes that have this terminal as the control terminal. 
Unless other arrangements have been made, this signal causes the 
processes to terminate. If the hangup signal is ignored, any subse- 
quent read returns with an end-of-file indication. Thus, programs that 
read a terminal and test for an end-of-file can terminate appropriately 
when hung up on. 

When one or more characters are written, they are transmitted to the 
terminal as soon as the previously typed characters have been entered. 
Input characters are echoed by putting them in the output queue as 
they arrive. If a process produces characters more rapidly than they 
can be typed, it will be suspended when its output queue exceeds a 
given limit. When the queue has drained down to the given threshold, 
the program is resumed. 



Several ioctl(S) system calls apply to terminal files. The primary calls 
use the following structure, defined in the file <termio.h>: 



#def ine NCC 8 
struct termio { 

unsigned short c_iflag; 
unsigned short c_oflag; 
unsigned short c_jcflag; 
unsigned short c_lflag; 
char c line; 



/* input modes */ 

/* output modes */ 

/* control modes */ 

/* local modes */ 

/* line discipline */ 



unsigned char c_cc [NCC] / /* control chars */ 



The special control characters are defined by the array c_cc . The rela- 
tive positions and initial values for each function are as follows: 



0 


VINTR 


DEL 


1 


VQUIT 


FS 


2 


VERASE 


Ctrl-H 


3 


VKILL 


Ctrl-U 


4 


VEOFA^MIN 


EOT 


5 


VEOLA^TIME 


NUL 


6 


VEOL2 


EOL 


7 


VSWTCH 


NUL 



The cjflag field describes the basic terminal input control: 



IGNBRK 


0000001 


Ignores break condition 


BRKINT 


0000002 


Signals interrupt on break 


IGNPAR 


0000004 


Ignores characters with parity errors 


PARMRK 


0000010 


Marks parity errors 


INPCK 


0000020 


Enables input parity check 


ISTRIP 


0000040 


Strips character 


INLCR 


0000100 


Maps ML to CR on input 


IGNCR 


0000200 


Ignores CR 
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ICRNL 


0000400 


lUCLC 


0001000 


IXON 


0002000 


IXANY 


0004000 


IXOFF 


0010000 



Maps CR to ML on input 
Maps uppercase to lowercase on input 
Enables start /stop output control 
Enables any character to restart output 
Enables start /stop input control 



If IGNBRK is set, the break condition (a character framing error with 
data all zeros) is ignored, that is, not put on the input queue and there- 
fore not read by any process. Otherwise, if BRKINT is set the break 
condition will generate an interrupt signal and flush both the input and 
output queues. If IGNPAR is set, characters with other framing and 
parity errors are ignored. 

If PARMRK is set, a character with a framing or parity error which is 
not ignored is read as the 3-character sequence: 0377, 0, X, where X 
is the data of the character received in error. To avoid ambiguity in 
this case, if ISTRIP is not set, a valid character of 0377 is read as 0377, 
0377. If PARMRK is not set, a framing or parity error which is not 
ignored is read as the character NUL (0). 



If INPCK is set, input parity checking is enabled. If INPCK is not set, 
input parity checking is disabled. This allows output parity generation 
without input parity errors. 

If ISTRIP is set, valid input characters are first stripped to 7-bits, other- 
wise all 8-bits are processed. 

If INLCR is set, a received NL character is translated into a CR charac- 
ter. If IGNCR is set, a received CR character is ignored (not read). 
Otherwise, if ICRNL is set, a received CR character is translated into a 
NL character. 

If lUCLC is set, a received uppercase alphabetic character is translated 
into the corresponding lowercase character. 

If IXON is set, start/stop output control is enabled. A received STOP 
character will suspend output and a received START character will 
restart output. All start/stop characters are ignored and not read. If 
IXANY is set, any input character will restart output which has been 
suspended. 



If IXOFF is set, the system will transmit START characters when the 
input queue is nearly empty and STOP characters when nearly full. 

If CTSFLOW or RTSFLOW are set, IXON and IXANY should also be 
set so that these two types of flow control do not interfere with each 
other. 



The RTS and CTS lines for the RS-232 (i.e. serial) interface were ori- 
ginally intended as handshaking signals between a Data Terminal 
Equipment (DTE) device (computer, printer, etc,) and a Data 
Communications Equipment (DCE) device (almost always a modem). 
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The RTS (Ready To Send) line is asserted by the DTE when it is ready 
to send data to the DCE. The DCE asserts the CTS (Clear To Send) 
line when it was ready to receive data. If the CTS line goes low, then 
the DTE should stop sending data until CTS goes high again. 

UNIX systems also use the RTS line for handshaking in the other 
direction. If the system sees that its input buffer is nearly full, it will 
lower the RTS line. The serial device should then stop sending, and 
wait for the system to catch up. The system will raise the RTS line 
when it is ready for more data. 

The initial input control value is all bits clear. 

The c_oflag field specifies the system treatment of output: 



OPOST 


0000001 


Postprocesses output 


OLCUC 


0000002 


Maps lowercase to uppercase on output 


ONLCR 


0000004 


Maps NXj to CR-NL on output 


OCRNL 


0000010 


Maps CR to NL on output 


ONOCR 


0000020 


No CR output at column 0 


ONLRET 


0000040 


NL performs CR function 


OFILL 


0000100 


Uses fill characters for delay 


OFDEL 


0000200 


Fills is DEL, else NUL 


NLDLY 


0000400 


Selects newline delays: 


NLO 


0 




NLl 


0000400 




CRDLY 


0003000 


Selects carriage return delays: 


CRO 


0 




CRl 


0001000 




CR2 


0002000 




CR3 


0003000 




TABDLY 


0014000 


Selects horizontal tab delays: 


TABO 


0 




TABl 


0004000 




TAB2 


0010000 




TABS 


0014000 


Expands tabs to spaces 


BSDLY 


0020000 


Selects backspace delays: 


BSO 


0 




BSl 


0020000 




VTDLY 


0040000 


Selects vertical tab delays: 


VTO 


0 




VTl 


0040000 




FFDLY 


0100000 


Selects form feed delays: 


FFO 


0 




FFl 


0100000 





If OPOST is set, output characters are post>processed as indicated by 
the remaining flags, otherwise characters are transmitted without 
change. 

If OLCUC is set, a lowercase alphabetic character is transmitted as the 
corresponding uppercase character. This function is often used in con- 
junction with lUCLC. 



March 15. 1989 



TERMIO-5 




TERMIO(M) 



TERMIO(M) 



If ONLCR is set, the NL character is transmitted as the CR-NL charac- 
ter pair. If OCRNL is set, the CR character is transmitted as the NL 
character. If ONOCR is set, no CR character is transmitted when at 
column 0 (first position). If ONLRET is set, the NL character is 
assumed to perform the carriage return function and the column 
pointer is set to 0 and the delays specified for CR will be used. Other- 
wise, the NL character is assumed to perform the linefeed function; 
the column pointer will remain unchanged. The column pointer is 
also set to 0 if the CR character is actually transmitted. 

The delay bits specify how long transmission stops to allow for 
mechanical or other movement when certain characters are sent to the 
terminal. In all cases, a value of 0 indicates no delay. If OFILL is set, 
fill characters will be transmitted for delay instead of a timed delay. 
This is useful for high baud rate terminals which need only a minimal 
delay. If OFDEL is set, the fill character is DEL, otherwise NUL. 

If a form feed or vertical tab delay is specified, it lasts for about 2 
seconds. 

Newline delay lasts about 0.10 seconds. If ONLRET is set, the car- 
riage return delays are used instead of the newline delays. If OFILL is 
set, 2 fill characters will be transmitted. 

Carriage return delay type 1 is dependent on the current column posi- 
tion, type 2 is about 0.10 seconds, and type 3 is about 0.15 seconds. If 
OFILL is set, delay type 1 transmits 2 fill characters, and type 2 
transmits 4 fill characters. 

Horizontal tab delay type 1 is dependent on the current column posi- 
tion. Type 2 is about 0.10 seconds. Type 3 specifies that tabs are to be 
expanded into spaces. If OFILL is set, 2 fill characters will be 
transmitted for any delay. 

Backspace delay lasts about 0.05 seconds. If OFILL is set, 1 fill char- 
acter will be transmitted. 

The actual delays depend on line speed and system load. 

The initial output control value is all bits clear. 

The cjoflag field describes the hardware control of the terminal: 



CBAUD 


0000017 


Baud rate: 


BO 


0 


Hang up 


B50 


0000001 


50 baud 


B75 


0000002 


75 baud 


BllO 


0000003 


110 baud 


B134 


0000004 


134.5 baud 


B150 


0000005 


150 baud 


B200 


0000006 


200 baud 


B300 


0000007 


300 baud 


B600 


0000010 


600 baud 
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B1200 


0000011 


1200 baud 


B1800 


0000012 


1800 baud 


B2400 


0000013 


2400 baud 


B4800 


0000014 


4800 baud 


B9600 


0000015 


9600 baud 


EXTA 


0000016 


External A 


EXTB 


0000017 


External B 


CSIZE 


0000060 


Character size: 


CSS 


0 


5 bits 


CS6 


0000020 


6 bits 


CS7 


0000040 


7 bits 


CS8 


0000060 


8 bits 


CSTOPB 


0000100 


Sends two stop bits, else one 


CREAD 


0000200 


Enables receiver 


PARENB 


0000400 


Parity enable 


PARODD 


0001000 


Odd parity, else even 


HUPCL 


0002000 


Hangs up on last close 


CLOCAL 


0004000 


Local line, else dial-up 


LOBLK 


0010000 


Block layer output 


CTSFLOW 


0020000 


Enables CTS protocol for a modem line 


RTSFLOW 


0040000 


Enables RTS signaling for a modem line 



The CBAUD bits specify the baud rate. The zero baud rate, BO, is used 
to hang up the connection. If BO is specified, the data-terminal-ready 
signal will not be asserted. Without this signal, the line is discon- 
nected if it is connected through a modem. For any particular 
hardware, impossible speed changes are ignored. 

The CSIZE bits specify the character size in bits for both transmission 
and reception. This size does not include the parity bit, if any. If 
CSTOPB is set, 2 stop bits are used, otherwise 1 stop bit. For example, 
at 1 10 baud, 2 stops bits are required. 

If PARENB is set, parity generation and detection is enabled and a par- 
ity bit is added to each character. If parity is enabled, the PARODD 
flag specifies odd parity if set, otherwise even parity is used. 

If CREAD is set, the receiver is enabled. Otherwise no characters will 
be received. 

If HUPCL is set, the line will be disconnected when the last process 
with the line open closes it or terminates. That is, the data-terminal- 
ready signal will not be asserted. 

If CLOCAL is set, the line is assumed to be a local, direct connection 
with no modem control. The data-terminal-ready and request-to-send 
signals are asserted, but incoming modem signals are ignored. If 
CLOCAL is not set, modem control is assumed. This means the data- 
terminal-ready and request-to-send signals are asserted. Also, the 
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carrier-detect signal must be returned before communications can 
proceed. 

If LOBLK is set, the output of a job control layer will be blocked when 
it is not the current layer. Otherwise the output generated by that 
layer will be multiplexed onto the current layer. 

The initial hardware control value after open is B9600, CSS, CREAD, 
HUPCL. 

The cjflag field of the argument structure is used by the line discip- 
line to control terminal functions. The basic line discipline (0) pro- 
vides the following: 

ISIG 0000001 Enable signals 

ICANON 0000002 Canonical input (erase and kill processing) 
XCASE 0000004 Canonical upper/lower presentation 

ECHO 0000010 Enables echo 

ECHOE 0000020 Echoes erase character as BS-SP-BS 

ECHOK 0000040 Echoes NL after kill character 

ECHONL 0000100 Echoes NL 

NOFLSH 0000200 Disables flush after interrupt or quit 
XCLUDE 0100000 Exclusive use of the line 

If ISIG is set, each input character is checked against the special con- 
trol characters INTR, SWTCH, and QUIT. If an input character 
matches one of these control characters, the function associated with 
that character is performed. If ISIG is not set, no checking is done. 
Thus, these special input functions are possible only if ISIG is set. 
These functions may be disabled individually by changing the value of 
the control character to an unlikely or impossible value (e.g., 0377). 

If ICANON is set, canonical processing is enabled. This enables the 
erase and kill edit functions, and the assembly of input characters into 
lines delimited by NL, EOF, and EOL. If ICANON is not set, read 
requests are satisfied directly from the input queue. A read will not be 
satisfied until at least VMIN characters have been received or the 
timeout value VTIME has expired and at least one character has been 
input. This allows fast bursts of input to be read efficiently while still 
allowing single character input. (See the discussion of VMIN and 
VTIME below.) 

The VMIN and VTIME values are stored in the position for the EOF 
and EOL characters respectively. VMIN and VTIME are interpreted as 
EOF and EOL if ICANON is set. Default VMIN and VTIME values a.*e 
stored in the /usr/include/sys/termio.h file. To change these values, 
set ICANON to off and use stty{C) to change the VMIN and VTIME 
values as represented by EOF and EOL. The TIME value represents 
tenths of seconds. 

If XCASE and ICANON are set, an uppercase letter is accepted on 
input by preceding it with a \ character, and is output preceded by a \ 
character. In this mode, the following escape sequences are generated 
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on output and accepted on input: 
For: Use: 

{ \( 

} \) 



For example, A is input as \a, \n as \\n, and \N as \\\n. 

If ECHO is set, characters are echoed as received. 

When ICANON is set, the following echo functions are possible. If 
ECHO and ECHOE are set, the erase character is echoed as ASCII BS 
SP BS, which will clear the last character from a CRT screen. If 
ECHOE is set and ECHO is not set, the erase character is echoed as 
ASCII SP BS. If ECHOK is set, the NL character will be echoed after 
the kill character to emphasize that the line will be deleted. Note that 
an escape character preceding the erase or kill character removes any 
special function. If ECHONL is set, the NL character will be echoed 
even if ECHO is not set. This is useful for terminals set to local echo 
(so-called half duplex). Unless escaped, the EOF character is not 
echoed. Because EOT is the default EOF character, this prevents ter- 
minals that respond to EOT from hanging up. 

If NOFLSH is set, the normal flush of the input and output queues asso- 
ciated with the quit and interrupt characters will not be done. 

If XCLUDE is set, any subsequent attempt to open the TTY device 
using openiS) will fail for all users except the super-user. If the call 
fails, it returns EBUSY in errno. XCLUDE is useful for programs 
which must have exclusive use of a communications line. It is not 
intended for the line to the program’s controlling terminal. XCLUDE 
must be cleared before the setting program terminates, otherwise sub- 
sequent attempts to open the device will fail. 

VMIN represents the minimum number of characters that should be 
received when the read is satisfied (i.e., the characters are returned to 
the user). VTIME is a timer of 0.10 second granularity used to time-out 
bursty and short-term data transmissions. The four possible values for 
VMIN and VTIME and their interactions are: 

VMIN > 0, VTIME > 0 

In this case, VTIME serves as an inter-character timer activated after 
the first character is received, and reset upon receipt of each character. 
VMIN and VTIME interact as follows: 

As soon as one character is received the inter-character timer is 
started. 
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If VMIN characters are received before the inter-character timer 
expires the read is satisfied. 

If the timer expires before VMIN characters are received the char- 
acters received to that point are returned to the user. 

A read(S) operation will sleep until the VMIN and VTIME 
mechanisms are activated by the receipt of the first character; thus, 
at least one character must be returned. 

VMIN > 0, VTIME = 0 

In this case, because VTIME = 0, the timer plays no role and only 
VMIN is significant. A read(S) operation is not satisfied until VMIN 
characters are received. 

VMIN = 0, VTIME > 0 

In this case, because VMIN = 0, VTIME no longer serves as an inter- 
character timer, but now serves as a read timer that is activated as 
soon as the read(S) operation is processed. A read(S) operation is 
satisfied as soon as a single character is received or the timer expires, 
in which case, the read(S) operation will not return any characters. 

VMIN = 0, VTIME = 0 

In this case, return is immediate. If characters are present, they will 
be returned to the user. 



The initial line-discipline control value is all bits clear. 
The primary ioctl(S) system calls have the form: 



ioctl (fildes, command, arg) 
struct termio *arg; 


The commands using this form are: 


TCGETA 


Gets the parameters associated with the terminal and 
stores them in the termio structure referenced by arg. 


TCSETA 


Sets the parameters associated with the terminal from 
the structure referenced by arg. The change is 
immediate. 


TCSETAW 


Waits for the output to drain before setting the new 
parameters. This form should be used when changing 
parameters that will affect output. 


TCSETAF 


Waits for the output to drain, then flushes the input 
queue and sets the new parameters. 



Additional ioctl (S) calls have the form: 
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ioctl (fildes, command, arg) 
int arg; 


The commands using this form are: 


TCSBRK 


Waits for the output to drain. If arg is 0, then sends a 
break (zero bits for 0.25 seconds). 


TCXONC 


Starts/stops control. If arg is 0, suspends output; if 1, 
restarts suspended output. 


TCFLSH 


If arg is 0, flushes the input queue; if 1, flushes the 
output queue; if 2, flushes bofli the input and output 
queues. 



Files 



/dev/tty 

/dev/tty* 

/dev/console 

See Also 



fork(S), ioctl(S), mapchan(F), mapchan(M), read(S), setgprp(S), 
signal(S), stty(C), tty(M), termios(M) 

Standards Conformance 



termio is conformant with: 

AT&TSVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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termios 

POSIX general terminal interface 
Description 



This page discusses the POSIX termios extensions to the termioQA) 
interface. Only those functions not described in termio(M) are 
described here. 

Certain characters have special functions on input. These functions 
and their default character values are summarized as follows: 

SUSP (ASCII NUL) If the ISIG flag is enabled, receipt of the SUSP 
character causes A SIGTSTP signal to be sent to the current 
process group. The SUSP character is discarded when 
processed. It is normally set to Ctrl-Z. 

Several library functions apply to terminal files. The primary calls use 
the following structure, defined in the file <termios.h>: 



tdefine NCOS 13 



struct termios { 
tcflag_t 


c_iflag; 


/* input modes */ 


tcflag_t 


c_oflag; 


/* output modes */ 


tcflag_t 


c_cflag; 


/* control modes */ 


tcflag_t 


c_lflag; 


/* local (line discipline) modes */ 


char 


c line; 


/* line discipline */ 


cc_t 


c_cc [NCCS] ; 


/* control chars */ 


char 


c_ispeed; 


/* input baud rate */ 


char 


c_ospeed; 


/* output baud rate */ 



}; 



The additional special control characters defined by the array c_cc. 
are: 

10 VSUSP NUL 

11 VSTART DCl 

12 VSTOP DCS 

The following additional line discipline (0) functions are available in 
the cjflag field: 

lEXTEN 0000400 enable extended functions 

TOSTOP 0001000 SIGTTOU on background output 

If lEXTEN is set, additional non-POSIX functions are recognized. This 
is the default. If lEXTEN is not set, the modes ICANON, ISIG, IXON, 
and IXOFF are assumed. 
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If TOSTOP is set, the signal SIGTTOU is sent to the process group of 
a process that tries to write to its controlling terminal if it is not the 
foreground process group. By default, this signal stops the members 
of the process group. If TOSTOP i$ not set, the output generated by the 
process is output to the current output stream. 

The associated library functions are found in tcattr(S) and tcflow(S). 

Files 



/dev/tty 

/dev/tty* 

/dev/console 

See Also 



ioctl(S), signal(S), stty(C), tcattr(S), tcflow(S), termio(M), tty(M) 

Standards Conformance 



termios is conformant with: 

IEEE POSIX Std 1003.1-1988 with C Standard Language-Dependent 
System Support; 

and The X/Open Portability Guide II of January 1987. 
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timod 

Transport Interface cooperating STREAMS module 

Description 



timod is a STREAMS module for use with the Transport Interface (TI) 
functions of the Network Services library. The timod module converts 
a set of ioctliS) calls into STREAMS messages that may be consumed 
by a transport protocol provider which supports the Transport Inter- 
face. This allows a user to initiate certain TI functions as atomic 
operations. 

The timod module must only be pushed (see Streams Primer) onto a 
stream terminated by a transport protocol provider which supports the 
TI. 

All STREAMS messages, with the exception of the message types gen- 
erated from the ioctl commands described below, will be transparently 
passed to the neighboring STREAMS module or driver. The messages 
generated from the following ioctl commands are recognized and pro- 
cessed by the timod module. The format of the ioctl call is: 

#include <sys/stropts.h> 



struct strioctl strioctl; 



strioctl.ic_cmd = cmd\ 
strioctl.ic_timeout = INFTIM; 
strioctl.ic Jen = size\ 
strioctl.ic_dp = (char *)buf 

ioctl(fildes, I_STR, &strioctl); 

where, on issuance, size is the size of the appropriate TI message to be 
sent to the transport provider and on return, size is the size of the ap- 
propriate TI message from the transport provider in response to the 
issued TI message, buf is a pointer to a buffer large enough to hold the 
contents of the appropriate TI messages. The TI message types are 
defined in <sys/tihdr.h>. The possible values for the cmd field are: 

TI_BIND Bind an address to the underlying transport protocol 

provider. The message issued to the TI_BIND ioctl 
is equivalent to the TI message type T_BIND_REQ 
and the message returned by the successful comple- 
tion of the ioctl is equivalent to the TI message type 
T_BIND_ACK. 
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TI_UNBIND Unbind an address from the underlying transport 
protocol provider. The message issued to the 
TI_UNBIND ioctl is equivalent to the TI message 
type T_UNBIND_REQ and the message returned by 
the successful completion of the ioctl is equivalent 
to the TI message type T_OK_ACK. 

TI_GETINFO Get the TI protocol specific information from the 
transport protocol provider. The message issued to 
the TLGETINFO ioctl is equivalent to the TI mes- 
sage type T_INFO_REQ and the message returned 
by the successful completion of the ioctl is 
equivalent to the TI message type T_INFO_ACK. 



TI_OPTMGMT Get, set, or negotiate protocol specific options with 
the transport protocol provider. The message issued 
to the TI_OPTMGMT ioctl is equivalent to the TI 
message type T_OPTMGMT_REQ, and the message 
returned by the successful completion of the ioctl is 
equivalent to the TI message type 
T_OPTMGMT_ACK. 



Files 



<sys/timod.h> 

<sys/tiuser.h> 

<sys/tihdr.h> 

<sys/ermo.h> 

See Also 



tirdwr(M) 

STREAMS Primer 
STREAMS Programmer's Guide 
Network Programmer' s Guide 

Diagnostics 



If the ioctl system call returns with a value greater than 0, the lower 8 
bits of the return value will be one of the TI error codes as defined in 
<sys/tiuser.h>. If the TI error is of type TSYSERR, then the next 8 bits 
of the return value will contain an error as defined in <sys/errno.h> 
[see intro{S)]. 
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timtbl 

create a time locale table 
Syntax 

timtbl [ specfile ] 

Description 



The utility timtbl is provided to allow new LC_TIME locales to be 
defined. It reads a specification file, which contains definitions of the 
way in which time and date information is presented for a particular 
locale, and produces a binary table file, to be read by setlocale (S), 
which determines the behavior of the strftime (S) routine. 

The information supplied in the specification file consists of lines in 
the following format: 

item = string 



The “=” can be separated from the item and string fields by zero or 
more space or tab characters. The following values are meaningful for 
item : 



DATE_FMT specification of the format string for representing the 
date. It will contain directives representing vari- 
able items such as the month number, as used in the for- 
mat string for strftime (S). 



TIME_FMT specification of the format string for representing the 
time of day. 

F_NOON string indicating 12-hour clock times before midday, 
e.g. “AM”. 



A_NOON 



string indicating 12-hour clock times after midday, e.g. 
“PM”. 



D_T_FMT string for formatting combined date and time. 
DAY_1 full name of the first day of the week (Sunday). 
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DAY_7 full name of the seventh day of the week. 

ABDAY_1 abbreviated name of the first day of the week, e.g. 
“Sun”. 



ABDAY_7 abbreviated name of the seventh day of the week. 
MON_l full name of the first month in the Gregorian calendar. 



MON_12 full name of the twelfth month. 
ABMON_l abbreviated name of the first month. 



ABMON_12 full name of the twelfth month. 

The string is a sequence of characters surrounded by quotes ("). Char- 
acters within the string can be specified both literally and using “\” 
escapes; the following three strings are equivalent: 

"Tuesday” - literal 

’\x54ueV73da\x79" - hexadecimal escapes 

'M 24ue\l 63da\l 71" - octal escapes 

The strings for the items DATE_FMT , TIME_FMT and D_T_FMT will 
also include directives as detailed in the strftime(S) manual 

page, to specify variable portions of the string. 

All characters following a hash (“#”) are treated as a comment and 
ignored up to the end of the line, unless the hash is within a quoted 
string. 

The various items may be specified in any order. If any items are not 
specified, a warning message will be produced, and the null string ("") 
substituted. 

The binary table output is placed in a file named “time”, within the 
current directory. This file should be copied or linked to the correct 
place in the setlocale file tree (see locale (M)). To prevent accidental 
corruption of the output data, the file is created with no write permis- 
sion; if the timtbl utility is run in a directory containing a write- 
protected ‘ ‘ctype’ ’ file, the utility will ask if the existing file should be 
replaced - any response other than “yes” or “y” will cause timtbl to 
terminate without overwriting the existing file. 
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If the specfile argument is missing, the specification information is 
read from the standard input. 

See Also 



chrtbl(M), locale(M), numtbl(M), setlocale(S), strftime(S) 

Diagnostics 



If the input table file cannot be opened for reading, processing will ter- 
minate with the error message, “Cannot open specification file”. 

Any lines in the specification file which are syntactically incorrect, or 
contain an urecognized value for the will cause an error message 
to be issued to the standard error output, specifying the line number on 
which the error was detected. The line will be ignored, and processing 
will continue. 

If a particular item is specified more than once, a warning message 
will be produced, and processing will continue. 

If the specification file does not contain specifications for all possible 
item s, a warning message will be produced. 

If the output file, time , cannot be opened for writing, processing will 
terminate with the error message, “Cannot create table file”. 

Any error conditions encountered will cause the program to exit with 
a non-zero return code; successful completion is indicated with a zero 
return code. 

Notes 



The strings D_FMT , T_FMT , AM_STR and PM_STR may be used as 
alternatives to DATE_FMT , TIME_FMT , F_NOON and A_NOON 
respectively, if required. These alternatives are provided for con- 
sistency with the identifiers used by nl_langinfo(S). 

Value Added 



timtbl is an extension of AT&T System V provided in Altos UNIX Sys- 
tem V. 
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tirdwr 

Transport Interface readAwrite interface STREAMS 
module 

Description 



tirdwr is a STREAMS module that provides an alternate interface to a 
transport provider which supports the Transport Interface (TI) func- 
tions of the Network Services library (see Section 3N). This alternate 
interface allows a user to communicate with the transport protocol 
provider using the read{S) and write(S) system calls. The putmsg(S) 
and getmsg(S) system calls may also be used. However, putmsg and 
getmsg can only transfer data messages between user and stream. 

The tirdwr module must only be pushed [see I_PUSH in streamioQs/^^ 
onto a stream terminated by a transport protocol provider which sup- 
ports the TI. After the tirdwr module has been pushed onto a stream, 
none of the Transport Interface functions can be used. Subsequent 
calls to TI functions will cause an error on the stream. Once the error 
is detected, subsequent system calls on the stream will return an error 
with errno set to EPROTO. 

The following are the actions taken by the tirdwr module when pushed 
on the stream, popped [see I_POP in streamioQsA)] off the stream, or 
when data passes through it. 

push - When the module is pushed onto a stream, it will check 
any existing data destined for the user to ensure that only 
regular data messages are present. It will ignore any mes- 
sages on the stream that relate to process management, 
such as messages that generate signals to the user pro- 
cesses associated with the stream. If any other messages 
are present, the I_PUSH will return an error with errno set 
to EPROTO. 

write - The module will take the following actions on data that 
originated from a write system call: 

- All messages with the exception of messages that con- 
tain control portions (see the putmsg and getmsg sys- 
tem calls) will be transparently passed onto the 
module’s downstream neighbor. 

- Any zero length data messages will be freed by the 
module and they will not be passed onto the module’s 
downstream neighbor. 
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- Any messages with control portions will generate an 
error, and any further system calls associated with the 
stream will fail with errno set to EPROTO. 

read - The module will take the following actions on data that 
originated from the transport protocol provider: 

- All messages with the exception of those that contain 
control portions (see the putmsg and getmsg system 
calls) will be transparently passed onto the module’s 
upstream neighbor. 

- The action taken on messages with control portions 
will be as follows: 

+ Messages that represent expedited data will 
generate an error. All further system calls asso- 
ciated with the stream will fail with errno set to 
EPROTO. 

+ Any data messages with control portions will 
have the control portions removed from the 
message prior to passing the message to the 
upstream neighbor. 

+ Messages that represent an orderly release indi- 
cation from the transport provider will generate 
a zero length data message, indicating the end 
of file, which will be sent to the reader of the 
stream. The orderly release message itself will 
be freed by the module. 

+ Messages that represent an abortive disconnect 
indication from the transport provider will cause 
all further write and putmsg system calls to fail 
with errno set to ENXIO. All further read and 
getmsg system calls will return zero length data 
(indicating end of file) once all previous data 
has been read. 

+ With the exception of the above rules, all other 
messages with control portions will generate an 
error and all further system calls associated with 
the stream will fail with errno set to EPROTO. 

- Any zero length data messages will be freed by the 
module and they will not be passed onto the module’s 
upstream neighbor. 

pop - When the module is popped off the stream or the stream is 
closed, the module will take the following action: 
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If an orderly release indication has been previously 
received, then an orderly release request will be sent 
to the remote side of the transport connection. 



See Also 



streamio(M), timod(M), intro(S), getmsg(S), putmsg(S), read(S), 
write(S), intro(S) 

STREAMS Primer 
STREAMS Programmer's Guide 
Network Programmer' s Guide 
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trchan 

translate character sets 

Syntax 

trchan [-ciko] mapfile 

Description 



trchan performs mapping as a filter, using the same format of mapfile 
as mapchan(M) (described in mapchan(¥)). This allows a file consist- 
ing of one internal character set to be “translated’ ’ to another internal 
character set. 

trchan reads standard input, maps it, and writes to standard output. A 
mapfile must be given on the command line. Errors cause trchan to 
stop processing unless -c is specified. 

The following options can be used with trchan : 

-c causes errors to be echoed on stderr, and processing is continued. 

-i specifies that the “input” section of the mapfile is used when 
translating data. 

-k specifies that the “dead” and “compose” sections of the mapfile 
are used when translating data. 

-o specifies that the “output” section of the mapfile is used when 
translating data. 

The -i, -k and -o options can be specified in any combination; if 
none are specified, trchan uses the entire mapfile, as if all three 
were specified together. 



Files 



/usr/lib/mapchan/* 

See Also 



ascii(M), mapchan(F), mapchan(M) 
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Notes 



TRCHAN (M) 



trchan currently ignores the control sections of the mapfile. 

Value Added 



trchan is an extension of AT&T System V provided in Altos UNIX 
System V. 
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tty 

special terminal interface 

Description 



The file /dev/tty is, in each process, a synonym for the control termi- 
nal associated with the process group of that process, if any. It is use- 
ful for programs or shell sequences that wish to be sure of writing 
messages on the terminal no matter how output has been redirected. It 
can also be used for programs that demand the name of a file for out- 
put, when typed output is desired, and when it is tiresome to find out 
what terminal is currently in use. 

The general terminal interface is described in termio (M). 

Files 



/dev/tty 

/dev/tty* 

See Also 

termio(M) 

Standards Conformance 



tty is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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tz 

time zone environment variable 
Syntax 

/etc/tz 

Description 



TZ is the shell environment variable for the time zone of the system 
and is set in the files /etc/default/login and /etc/TiMEZONE (see 
timezone(F) for a complete description of the syntax for defining TZ). 

The shell script letcitz, generally run during installation, prompts for 
the correct time zone, prompts for the dates when time is shifted from 
standard to daylight time and back, and for the number of hours to 
shift (partial hours in the form of hh:mm:ss are acceptable), and sets 
TZ correctly in the appropriate files. The following files are exam- 
ined to see if they read from /etc/TIMEZONE to set TZ for their 
environment: 

/etc/cshrc 

/etc/profile 

/etc/rc2 

/.profile 

If these files do not read from /etc/TIMEZONE, a warning is issued. 

Users living in a time zone different than that of the host machine may 
change TZ in their $HOME/.profile or $HOME/.login files. 

To change the time zone for the entire system, run the shell script 
/etc/tz (as root) or use an editor to change the variable TZ in the files 
/etc/TIMEZONE and /etc/default/login. The TZ variable in 
/etc/default/login causes the time zone to be set correctly on logging 
in and for programs such as uucico. 

Files 



/etc/rc2 

/etc/default/login 

Ir\cI\7 

$HOME/.profile 

$HOME/.login 
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See Also 



environ(M), date(C), timezone(F), ctime(S) 

Notes 



The dateiC) automatically switches from Standard Time to Summer 
Time (Daylight Saving Time). Leap days are properly accounted for. 

Changes to TZ are immediately effective, (i.e. if a process changes the 
TZ variable, the next call to a ctime(S) routine returns a value based 
on the new value of the variable). 
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values 

machine-dependent values 

Syntax 



#include <values.h> 

Description 



This file contains a set of manifest constants, conditionally defined for 
particular processor architectures. 

The model assumed for integers is binary representation (one’s or 
two’s complement), where the sign is represented by the value of the 
high-order bit. 

BTTS(type ) The number of bits in a specified type (e.g., 

int). 

HIBITS The value of a short integer with only the 

high-order bit set (in most implementations, 
0x8000). 



HIBITL 

HIBITI 

MAXSHORT 

MAXLONG 

MAXINT 



The value of a long integer with only the 
high-order bit set (in most implementations, 
0x80000000). 

The value of a regular integer with only the 
high-order bit set (usually the same as HIBITS 
or HIBITL). 

The maximum value of a sign ed sh ort integer 
(in most implementations, 0x7FFF = 32767). 

The maximum value of a signed long integ er 
(in most implementations, 0x7FFFFFFF = 
2147483647). 

The maximum value of a signed regular 
integer (usually the same as MAXSHORT or 
MAXLONG). 



MAXFLOAT, LN_MAXFLOAT The maximum value of a single- 
precision floating-point number, 
and its natural logarithm. 
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MAXDOUBLE,LN_MAXDOUBLE The maximum value of a 

double-precision floating-point 
number, and its natural loga- 
rithm. 



MINFLOAT, LN_MINFLOAT The minimum positive value of a 

single-precision floating-point 
number, and its natural loga- 
rithm. 

MINDOUBLE, LN_MINDOUBLE The minimum positive value of a 

double-precision floating-point 
number, and its natural loga- 
rithm. 

FSIGNIF The number of significant bits in the mantissa 

of a single-precision floating-point number. 

DSIGNIF The number of significant bits in the mantissa 

of a double-precision floating-point number. 



See Also 



intro(S), limits(F), math(M) 

Standards Conformance 



values is conformant with: 

The X/Open Portability Guide II of January 1987. 



March 1 5, 1 989 



VALUES-2 






XTPROTO (M) 



XTPROTO (M) 



xtproto 

multiplexed channels protocol used by xt(HW) driver 
Description 



The xt(¥TW) driver contains routines which implement a multiplexed, 
multi-buffered, full-duplex protocol with guaranteed delivery of 
ordered data via an 8-bit byte data stream. This protocol is used for 
communication between multiple UNIX system host processes and an 
AT&T windowing terminal operating under layersiC). 

The protocol uses packets with a 2-byte header containing a 3-bit 
sequence number, 3-bit channel number, control flag, and data size. 
The data part of a packet may not be larger than 32 bytes. The trailer 
contains a CRC-16 code in 2 bytes. Each channel is double-buffered. 

Correctly received packets in sequence are acknowledged with a con- 
trol packet containing an ACK; however, out of sequence packets gen- 
erate a control packet containing a NAK, which will cause the 
retransmission in sequence of all unacknowledged packets. 

Unacknowledged packets are retransmitted after a timeout interval 
which is dependent on baud rate. Another timeout parameter specifies 
the interval after which incomplete receive packets are discarded. 

Files 



/usr/include/sys/xtproto.h channel multiplexing protocol definitions 

See Also 



layers(M), layers(C), xt(HW) 
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Intro 

Introduction to file formats 

Description 



This section outlines the formats of various files. The C struct 
declarations for the file formats are given where applicable. Usually, 
these structures can be found in the directories /usr/include or 
/usr/include/sys. Note that include files are part of the Development 
System. 
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86rel 

Intel 8086 Relocatable Format for Object Modules 
Syntax 

#indude <sys/relsym86.h> 

Description 



Intel 8086 Relocatable Format, or 86rel, is the object module format 
generated by masm{CP), and the input format for the linker ld{C?). 
The include file relsym86.h specifies appropriate definitions to access 
86rel format files from C. For the technics details of the 86rel for- 
mat, see Intel 8086 Object Module Format External Product Specifi- 
cation . 

An 86rel consists of one or more variable length records. Each record 
has at least three fields: the record type, length, and checksum. The 
first byte always denotes the record type. There are thirty-one dif- 
ferent record types. Only eleven are used by ld(CP) and masm(CP). 
The word after the first byte is the length of the record in bytes, 
exclusive of the first three bytes. Following the length word are typi- 
cally one or more fields. Each record type has a specific sequence of 
fields, some of which may be optional or of varying length. The very 
last byte in each record is a checksum. The checksum byte contains 
the sum modulo 256 of all other bytes in the record. The sum modulo 
256 of all bytes in a record, including the checksum byte, should equal 
zero. 

With few exceptions, 86rel strings are length prefixed and have no 
trailing null. The first byte contains a number between 0 and 40, 
which is the remaining length of the string in bytes. Although the 
Intel specification limits the character set to upper case letters, digits, 
and the characters “?”, and ?nasm(CP) uses the 

complete ASCII character set. 

The Intel Object Module Format (OMF) specification uses the term 
“index” to mean a positive integer either in the range 0 to 127, or 128 
to 32,768. This terminology is retained in this document and else- 
where in the 86rel literature. An index has one or two bytes. If the 
first byte has a leading 0 bit, the index is assumed to have only one 
byte, and the remainder of the byte represents a positive integer 
between 0 and 127. If the second byte has a leading 1 bit, the index is 
assumed to take up two bytes, and the remainder of the word 
represents a positive integer between 128 and 32,768. 



March 13, 1990 



86REL-1 






86REL(F) 



86REL(F) 



Following is a list of record types and the hexadecimal value of their 
first byte, as defined in relsym86.h. 



#define MRHEADR 
#define MREGUSTT 
#define MREDAIA 
#def ine MRIDAIA 
#define MOVIDEF 
tdefine MENDREC 
#def ine MBLKDEF 
#def ine MBLKEND 
#define MDEBSYM 
#def ine MTHEADR 

#def ine MLHEADR 
#define MPEDMA 
#define MPIDAIA 

#define MCOMENT 
#define MMCDEND 
#define MEXTDEF 
#def ine MTYPDEF 
#define MPUBDEF 
#define MLOCSYM 
#define MLINNUM 
#define Mli^AMES 
#def ine MSEGDEF 
#def ine M3RPDEF 
#define MFIXUPP 
#define 

fdefine MLEDMA 
#define MLIDAEA 

#def ine MLIBHED 
#def ine MLIBNAM 
#def ine MLIBLOC 
#define MLIBDIC 
#define M386END 
#c3efine MPUB386 
#define MLOC386 
#define MLIN386 
#define MSEG386 
#define MFIX386 
#define MLED386 
#define MLID386 



0x6e /*rel module header/* 

0x70 /*register initialization*/ 

0x72 /*explicit (enumerated) data image*/ 

0x74 /* repeated (iterated) data image*/ 

0x76 /*overlay definition*/ 

0x78 /*block or overlay end record*/ 

0x7a /*block definition*/ 

0x7c /*block end*/ 

0x7e /*debug syrrbols*/ 

0x80 /*module header, 

*usually first in a rel file*/ 

0x82 /*link module header*/ 

0x84 /*absolute data image*/ 

0x86 /*absolute repeated (iterated) 

*data image*/ 

0x88 /*coiTment record*/ 

0x8a /*module end record*/ 

0x8c /*extemal definition*/ 

0x8e /*type definition*/ 

0x90 /*public definition*/ 

0x92 /*local symbols*/ 

0x94 /*source line number*/ 

0x96 /*name list record*/ 

0x98 /*segment definition*/ 

0x9a /*group definition*/ 

0x9c /*fix up previous data image*/ 

0x9e /*none*/ 

OxaO /*logical data image*/ 

0xa2 /* logical repeated (iterated) 

*data image*/ 

0xa4 /*library header*/ 

0xa6 /*library names record*/ 

0xa8 /*library module locations*/ 

Oxaa /*library dictionary*/ 

0x86 /*32 bit module end record*/ 

0x91 /*32 bit public definition*/ 

0x93 /*32 bit logical symbols*/ 

0x95 /*32 bit source line number*/ 

0x99 /*32 bit segment definition*/ 

0x9d /*fix i;^ previous 32 bit data image*/ 

Oxal /*32 bit logical data image*/ 

0xa3 /*32 bit logical repeated (iterated) data image*/ 



In the following discussion, the salient features of each record type are 
given. If the record is not used by either masm(CF) or /<i(CP), it is not 
listed. 



THEADR The record type byte is 0x80. The THEADR record 
specifies the name of the source module at assembly- 
time (see Notes). The sole field is the T-MODULE 
NAME , which contains a length-prefixed string 
derived from the base name of the source module. 
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COMENT 



MODEND 



EXTDEF 



TYPDEF 



PUBDEF 



LNAMES 



The record type byte is 0x88. The COMENT record 
may contain a remark generated by the compiler sys- 
tem. masm{C^) inserts the string “UNIX 8086 
ASSEMBLER 

The record type byte is 0x8a. The MODEND record 
terminates a module. It can specify whether the 
current module is to be used as the entry point to the 
linked executable. If the module is an endy point, the 
MODEND record can then specify the address of the 
entry point within the executable. 

The record type byte is 0x8c. The EXTDEF record 
contains the names and types of symbols defined in 
other modules by a PUBDEF record (see below). This 
corresponds to the C storage class “extern.” The 
fields consist of one or more length-prefixed strings, 
each with a following type index. The indices refer- 
ence a TYPDEF record seen earlier in the module. 
masm{CP) generates only one EXTDEF per exterior 
symbol. 

The record type byte is 0x8e. The TYPDEF record 
gives a description of the type (size and storage 
attributes) of an object or objects. This description 
can then be referenced by EXTDEF , PUBDEF , and 
other records. 

The record type byte is 0x90. The PUBDEF record 
gives a list of one or more names that may be refer- 
enced by other modules at link-time (“publics”). The 
list of names is preceded by a group and segment 
index, which reference the location of the start of the 
list of publics within the current segment and group. 
If the segment and group indices are zero, a frame 
number is given to provide an absolute address in the 
module. The list consists of one or more of length- 
prefixed strings, each associated with a 16-bit offset 
within the current segment and a type index referring 
to a TYPDEF . 

The record type byte is 0x96. The LNAMES record 
gives a series of length-prefixed strings which are 
associated with name indices within the current 
module. Each name is indexed in sequence given 
starting with 1. The names may then be referenced 
within the current module by successive SEGDEF and 
GRPDEF records to provide strings for segments, 
classes, overlays or groups. 



March 13, 1990 



86REL-3 




86REL(F) 



86REL(F) 



SEGDEF The record type byte is 0x98. The SEGDEF record pro- 
vides an index to reference a segment, and informa- 
tion concerning segment addressing and attributes. 
This index may be used by other records to refer to the 
segment. The first byte in the record after the length 
field gives information about the alignment, and about 
combination attributes of the segment. The next v^ord 
is the segment length in bytes. Note that this restrains 
segments to a maximum 65,536 bytes in length. Fol- 
lowing this word is an index (see above) for the seg- 
ment. Lastly, the SEGDEF may optionally contain 
class and/or overlay index fields. 

GRPDEF The record type is 0x9a. The GRPDEF record provides 
a name to reference several segments. The group 
name is implemented as an index (see above). 

FIXUPP The record byte is 0x9c. The FDCUPP record specifies 

one or more load-time address modifications 
(“fixups”). Each fixup refers to a location in a 
preceding LEDATA (see below) record. The fixup is 
specified by four data; a location, a mode, a target and 
a frame. The frame and target may be specified ex- 
plicitly or by reference to an already defined fixup. 

LEDATA The record type byte is OxaO. This record provides a 
contiguous text or data image which the loader W(CP) 
uses to construct a portion of an 8086 run-time execut- 
able. The image might require additional processing 
(see FDCUPP) before being loaded into the executable. 
The image is preceded by two fields, a segment index 
and an enumerated data offset. The segment index 
(see INDEX) specifies a segment given by a previously 
seen SEGDEF . The enumerated data offset (a word) 
specifies the offset from the start of this segment. 

See Also 

as(CP), Id(CP) 

Notes 

If you attempt to load a number of modules assembled under the same 
basename, the loader will try to put them all in one big segment. In 
286 programs, segment size is limited to 64K. In a large program the 
resulting segment size can easily exceed 64K. A large model code 
executable results from the link of one or more modules, composed of 
segments that aggregate into greater than 64K of text. 
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Hence, be sure that the assembly-time name of the module has the 
same basename as the source. This can occur if the source module is 
preprocessed not by cc(CP), but, for example, by hand or shell script, 
prior to assembly. The following example is incorrect: 

#incorrect 

cc -E modulel.c I filter > x.c 
cc x.c 

mv x.o module 1 .0 

cc -E modulel.c I filter > x.c 

cc x.c 

mv x.o modulel.o 

cc -E modules .c I filter > x.c 

cc x.c 

mv x.o modules .0 

Id module 1.0 modulel.o modules .o 



To avoid this, each of the modules should have a unique name when 
assembled, as follows: 

#correct 

cc -E modulel.c I filter > x.c 
cc -S x.c 

mv x.s modulel.s 
as modulel.s 



Id module 1.0 modulel.o moduleS.o 

Value Added 



86rel is an extension of AT&T System V provided in Altos UNIX Sys- 
tem V. 
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a.out 

UNIX common assembler and link editor output 
Syntax 



#include <a.out.h> 

Description 



The file name a.out is the default output file name from the link editor 
/<i(CP). The link editor will make a.out executable if there were no 
errors in linking. The output file of the UNIX assembler as (CP) also 
follows the common object file format of the a.out file although the 
default file name is different. 

A common object file consists of a file header, a UNIX system header 
(if the file is link editor output), a table of section headers, relocation 
information, (optional) line numbers, a symbol table, and a string 
table. The order is given below. 

File header. 

UNIX system header. 

Section 1 header. 

Section n header. 

Section 1 data. 

Section n data. 

Section 1 relocation. 

Section n relocation. 

Section 1 line numbers. 

Section n line numbers. 

Symbol table. 

String table. 

The last three parts of an object file (line numbers, symbol table and 
string table) may be missing if the program was linked with the -s 
option of ld{CP) or if they were removed by strip (CP). Also note that 
the relocation information will be absent after linking unless the -r 
option of W(CP) was used. The string table exists only if the symbol 
table contains symbols with names longer than eight characters. 

The sizes of each section (contained in the header, discussed below) 
are in bytes. 
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When an a.out file is loaded into memory for execution, three logical 
segments are set up: the text segment, the data segment (initialized 
data followed by uninitialized, the latter actually being initialized to 
all O’s), and a stack. On your computer, the text segment starts at 
location virtual address 0. 



The a.out file produced by /<i(CP) may have one of two magic numbers 
in the first field of the UNIX system header. A magic number of 0410 
indicates that the executable must be swapped through the private 
swapping store of the UNIX system, while the magic number 0413 
causes the system to attempt to page the text directly from the a.out 
file. 

In a 0410 executable, the text section is loaded at virtual location 
0x00000000. The data section is loaded immediately following the 
end of the text section. 

For a 0413 executable, the headers (file header, UNIX system header, 
and section headers) are loaded at the beginning of the text segment 
and the text immediately follows the headers in the user address 
space. The first text address will equal the sum of the sizes of the 
headers, and will vary depending on the number of sections in the 
a.out file. In an a.out file with 3 sections (.text, .data, and .bss) the first 
text address is at OxOOOOOODO. The data section starts in the next page 
table directory after the last one used by the text section, in the first 
page of that directory, with an offset into that page equal to the 1st 
unused memory offset in the last page of text. That is to say, given 
that etext is the address of the last byte of the text section, the 1st byte 
of the data section will be at 0x00400000 + {etext 8 l OxFFCOOOOO) + 
{{etext^l) & OxFFCOOFFF). 

On the 80386 computer the stack begins at location 7FFFFFFC and 
grows toward lower addresses. The stack is automatically extended as 
required. The data segment is extended only as requested by the 
brk{S) system call. 

For relocatable files the value of a word in the text or data portions 
that is not a reference to an undefined external symbol is exactly the 
value that will appear in memory when the file is executed. If a word 
in the text involves a reference to an undefined external symbol, there 
will be a relocation entry for the word, the storage class of the 
symbol-table entry for the symbol will be marked as an “external 
symbol”, and the value and section number of the symbol-table entry 
will be undefined. When the file is processed by the link editor and 
the external symbol becomes defined, the value of the symbol will be 
added to the word in the file. 



March 15. 1989 



A.OUT-2 




A.OUT (F) 



A.OUT (F) 



File Header 

The format of the filehdr header is: 

struct filehdr 

{ 



unsigned short 


f_magic; 


/* magic number */ 


unsigned short 


f_nscns; 


/* number of sections */ 


long 


f_timdat; 


/* time and date stanp */ 


long 


f__symptr; 


/* file ptr to symtab */ 


long 


f_nsyms; 


/* # symtab entries */ 


unsigned short 


f_opthdr; 


/* sizeof(opt hdr) */ 


unsigned short 


f__flags; 


/* flags */ 



UNIX System Header 
The format of the UNIX system header is: 



typedef struct aouthdr 
{ 



short 


magic; 


/♦ 


short 


vstanp; 


/* 


long 


tsize; 


/* 


long 


dsize; 


/* 


long 


bsize; 


/* 


long 


entry; 


/* 


long 


text_start; 


/♦ 


long 


data_start; 


/* 


AOUTHDR; 







magic number */ 

version stanp */ 

text size in bytes, padded */ 

initialized data (.data) */ 

uninitialized data (.bss) */ 

entry point */ 

base of text used for this file */ 
base of data used for this file */ 



Section Header 

The format of the section header is: 

struct scnhdr 

{ 



char 


s name [SYMNMLEN] ;/* section name */ 


long 


s_paddr; 


/* physical address */ 


long 


s__vaddr; 


/* virtual address */ 


long 


s__size; 


/* section size */ 


long 


s__scnptr; 


/* file ptr to raw data */ 


long 


s_relptr; 


/* file ptr to relocation */ 


long 


s__lnnoptr; 


/* file ptr to line numbers */ 


unsigned short 


sjareloc; 


/* # reloc entries */ 


unsigned short 


s__nlnno; 


/* # line number entries */ 


long 


s_flags; 


/* flags */ 
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Relocation 

Object files have one relocation entry for each relocatable reference in 
the text or data. If relocation information is present, it will be in the 
following format: 

struct reloc 

{ 



long 


r_vaddr; 


/♦ 


(virtual) address of reference */ 


long 


r_symndx; 


/* 


index into symbol table */ 


ushort 


r_type; 


/* 


relocation type */ 



}; 

The start of the relocation information is s relptr from the section 
header. If there is no relocation information, s relptr is 0. 



Symbol Table 

The format of each symbol in the symbol table is 



#c3efine SYMNMLEasr 8 
#define FIUJMLEN 14 
#define DIMNUM 4 



struct syinent 

{ 

union /* 

{ 

char _n_name [SYMNWIEN] 



struct 

{ 



long 


_n_zeroes; 


/* 


long 


_n_offset; 


/♦ 


} _n_n; 


char 


*_n_nptr[2] ; 


/♦ 


} _n; 


long 


n_value; 


/♦ 


short 


n_scnum; 


/♦ 


unsigned short 


n_type; 


/♦ 


char 


n_sclass; 


/♦ 


char 


n_numaux; 


/♦ 



}; 



all ways to get a syrtbol name ♦/ 
; /♦ name of synbol */ 



== OL if in string table */ 
location in string table */ 

allows overlaying */ 

value of syrrbol */ 
section nurber */ 
type and derived type */ 
storage class ♦/ 
nuntoer of aux entries */ 



tdefine n_name _n._n_name 
#define n_zeroes _n._n_n._n_zeroes 
#define n_offset _n ._n_n ._n_of f set 
#def ine n_npt r _n ._n_npt r [ 1 ] 

Some symbols require more information than a single entry; they are 
followed by auxiliary entries that are the same size as a symbol entry. 
The format follows. 
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union auxent { 
struct { 

long x_tagndx; 
union { 

struct { 

unsigned short x_lnno; 
unsigned short x_size; 

} x_lnsz; 

long x_fsize; 

} x_misc; 
union { 

struct { 

long x_lnnoptr; 
long x_endndx; 

} x_fcn; 
struct { 

unsigned short x_dimen [dimnum] ; 

} x_ary; 

} x_fcnary; 

unsigned short x_tvndx; 

} x_sym; 

struct { 

char x_fname [FIIMILEN] ; 

} x_file; 

struct { 

long x_scnlen; 

unsigned short x_nreloc; 
unsigned short x_nlinno; 

} x_scn; 



struct { 



} 



long 

unsigned short 
unsigned short 

X tv; 



x_tvfill; 
x_tvlen; 
x_tvran[2] ; 



Indexes of symbol table entries begin at zero. The start of the symbol 
table i^f symptr (from the file header) bytes from the beginning of the 
file. If the symbol table is stripped, is 0. The string table (if 
one exists) begins at f_symptr + (fjnsyms * S YMESZ) bytes from the 
beginning of the file. 

See Also 



as(CP), cc(CP), Id(CP), brk(S). filehdr(F), Idfcn(F), linenum(F), 
reloc(F), scnhdr(F), syms(F). 
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acct 

format of per-process accounting file 
Description 



Files produced as a result of calling acct(S) have records in the form 
defined by <sys/acct.h>. 

In ac Jlag , the AFORK flag is turned on by each fork(S) and turned off 
by an exec(S). The ac comm field is inherited from the parent pro- 
cess and is reset by any exec . Each time the system charges the pro- 
cess with a clock tick, it also adds the current process size to acjnem 
computed as follows: 

(data size) + (text size) / (number of in-core processes using text) 

The value of acjnem! ac_stime can be viewed as an approximation to 
the mean process size, as modified by text-sharing. 

See Aiso 



acctcom(ADM), acct(S) 

Notes 



The acjnem value for a short-lived command gives little information 
about the actual size of the command, because ac mem may be incre- 
mented while a different command (e.g., the shell) is being executed 
by the process. 

Standards Conformance 



acct is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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ar 

archive file format 

Description 



The archive command ar is used to combine several files into one. 
Archives are used mainly as libraries to be searched by the link editor 
ld(C), 

A file produced by ar has a magic number at the start, followed by the 
constituent files, each preceded by a file header. The magic number is 
0177545 octal (or 0xff65 hexadecimal). The header of each file is 
declared in /usr/include/ar.h. 

Each file begins on a word boundary; a null byte is inserted between 
files if necessary. Nevertheless the size given reflects the actual size 
of the file exclusive of padding. 

Notice there is no provision for empty areas in an archive file. 

See Also 



ar(CP), Id(CP) 
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archive 

default backup device information 

Description 

The /etc/default/archive file contains information on system default 
backup devices for use by sysadmsh(ADM), The device entries are in 
the following format: 

name=value [name=value] ... 

value may contain white spaces if quoted, and newlines may be 
escaped with a backslash. 

The following names are defined for /etc/default/archive: 

bdev Name of the block interface device. 

cdev Name of the character interface device. 

size Size of the volume in either blocks or feet. 

density Volume density, such as 1600. If this value is miss- 

ing or null, then size is in blocks; otherwise the size 
is in feet. 

format Command used to format the archive device, 

blocking Blocking factor. 

desc A description of the device, such as “Cartridge 

Tape.” 

See Also 

sysadmsh(ADM) 



March 13, 1990 



ARCHIVE-1 







AUTHCAP(F) 



AUTHCAP(F) 



authcap 

authentication database 

Syntax 

/etc/auth/* 

/tcb/files/auth/* 

Description 



The database contains authentication and identity information for 
users, kernels, and TCB files as well as system-wide parameters. It is 
intended to be used by programs to interrogate user and system values, 
as well as by authentication programs to u^ate that information. 



Structure of the Hierarchies 



The complete database resides in two hierarchies: /tcb/files/auth and 
/etc/auth. The first hierarchy deals with user-specific files, and has 
subdirectories of one letter each of which is the starting letter for user 
name. Within each of these directories are regular files, each contain- 
ing an authcap {¥) format file for a particular user. Thus, all user 
names beginning with x have their respective authentication and iden- 
tity information in a file in directory /tcb/files/auth/x. 

The directories within /etc/auth contain system-wide information. 
The global system settings reside in the /etc/au th/system directory. 
The subsystem authorizations associated with each protected subsys- 
tem (a protected subsystem is privileged but does not require global 
authority to perform actions) are located in the /etc/au th/subsystems 
directory. 

The following database files are contained in the system directory: 



default Default Control 

files File Control 

ttys Terminal Control 

authorize Primary and Secondary 

Authorization Control File 
devassign Device Assignment 



A subsystem file name is the group name associated with the pro- 
tected subsystem. The owner of all files is auth and the group is the 
group of the subsystem. Only the owner and group of this file may 
view the contents. The file dflt_users lists the users granted default 
subsystem authorizations. 
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Format of a File 

Each data file in the hierarchy, whether system-wide or user-specific, 
has the same format. Each user file consists of one virtual line, 
optionally split into multiple physical lines with the 7’ character 
present at the very end of all lines but the last. For instance, the line 

blf ; u_name=blf : u_id#16 : u_encrypt=a78/al . eitf n6 : u_type=sso : chkent : 

may be split into: 



blf ;u_name=blf :u_id#16 : \ 

: u_encrypt=a78/al .eitfn6 : \ 

: u_type=sso : chkent : 

Note that all capabilities must be immediately preceded and followed 
with the separator; multiple line entries require additional ones - 
one more per line. Multiple entries are separated by a newline: 

drb : u_naitie=drb : u_id#7 5 : u_maxtries#9 : u_type=general : chkent : 
blf : u_name=blf : u_id#7 6 : u_maxtries#5 : u_type=general : chkent : 

For subsystem files, the file is a set of lines, each containing a user 
name terminated by a colon, followed by a comma- separated list of 
primary and secondary authorizations defined for that subsystem. 



Format of a Line 

The format of a line (except for subsystem files) is briefly as follows: 

namelalt name(s)ldescription:capl :cap2:cap3 ,.:capn:chkent: 

The entry can be referenced by the name or any of the alternate 
names. A description field may document the entry. The entry 
name(s) and description are separated by the ‘T character. The end of 
the name/description part of the entry is terminated by the charac- 
ter. Alternate names and the description fields are optional. 

At the end of each entry is the chkent field. This is used as an 
integrity check on each entry. The authcap(S) routines will reject all 
entries that do not have chkent at the very end. 

Each entry has 0 or more capabilities, each terminated with the 
character. Each capability has a unique name. Numeric capabilities 
have the format: 

id#«Mm 

where num is a decimal or (0 preceded) octal number. Boolean capa- 
bilities have the format: 
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id 



or 



id@ 

where the first form signals the presence of the capability and the 
second form signals the absence of the capability. String capabilities 
have the format: 

id=string 

where string is 0 or more characters. The ‘V and characters are 
escaped as ‘\V and respectively. Although it is not recommended, 
the same id may be used for different numeric, boolean, and string 
capabilities. 

See Also 



getprpwent(S), getdvagent(S), getprtcent(S), getprfient(S) 

Value Added 



authcap is an extension of AT&T System V provided in Altos UNIX 
System V. 
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cardjnfo 

system tty controller card information file 

Description 



The card_info file is used by pcu(ADM) to map tty inittab(F) entries 
to installed tty controller cards. Boards that control both serial and 
parallel ports and that use different drivers to support these ports will 
have two entries in the card__info file. 

Each line must contain the following seven fields, each separated by a 
colon: 

ID:portjtype:board_name:regexp:format:range:package_id 

The first five fields are mandatory. The sixth and seventh fields are 
only used by ISA tty controller card entries and should be blank for 
EISA tty controllers. Each field is described below: 

ID This field contains the uncompressed EISA identifier for the 
board. A full seven-character ID (for example, ACS0301) can 
be used, but the minor revision number may be omitted (for 
example, ACS030). For ISA tty controller boards field one con- 
tains the word ISA. 

portjype 

This field contains the type of the ports on the board or the EISA 
subfunction type string. This string can be a simple EISA type 
(e.g. COM,MDC), or may include subtype information (e.g., 
COM,ASY;COMl). In addition, an abbreviated type string can 
be used. For example, COM,ASY will match both 
COM,ASY;COMl and COM,ASY;COM2 on the specified 
board. For ISA tty controller boards this field should contain 
one of the following types: 

COM - Indicates that this is a normal serial communications 
port. 

PAR - Indicates that this is a parallel printer port. 
boardjiame 

This field contains the full name of the board which is displayed 
for the user in the title bar of the ports window in pcu. 

regexp 

This field contains a regex{^) pattern to identify the ports that 
belong to this board or subfunction. This regex pattern returns a 
value (usually numeric) that distinguishes one port on the board 
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from the next. For example, if the pattern tty([0-9]{2,4})$0 was 
given the port name tty03, the 03 would be returned and regex 
would succeed. 

format 

This field contains a printfiS) format string for printing a port’s 
ttyname and takes as its single argument the value returned by 
the regexp pattern from field four. For example, the format 
string tty%02d would be used with the regexp pattern example 
given above. Also note that the format string should be for the 
non-modem tty port name. For example, for coml/com2 ports 
use tty%da not tty%dA. 



range 

This field contains a range of numbers of the form n7-n2 used as 
arguments to the format string in field five to generate the 
ttynames for the non-modem ports attached to the board. This 
field is for ISA entries only. For EISA entries pcu gets the port 
range from the sloMnfo file, which is created by uconfig and its 
execution of /etc/conf/pack.d/*/*node scripts. 

packagejd 

This field contains the device driver device name for the board 
as found in the first field of the device driver’s mdevice(F) file 
entry. This field is for ISA entries only. For EISA entries pcu 
gets the package_id from slot_info, which is created by uconfig. 



Files 



/etc/card_info 

/etc/slot_info 

See Also 



pcu(ADM), uconfig(ADM) 

Value Added 



cardjnfo is an extension to AT&T UNIX System V provided in Altos 
UNIX System V. 
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checklist 

list of file systems processed by fsck(ADM) 

Description 

The /etc/checklist file contains a list of the file systems to be checked 
when (ADM) is invoked without arguments. The list contains at 
most 15 special file names. Each special file name must be on a 
separate line and must correspond to a file system. 

See Aiso 

fsck(ADM) 
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clock 

the system real-time (time of day) clock 

Description 



The clock file provides access to the battery-powered, real-time time 
of day clock. Reading this file returns the current time; writing to the 
file sets the current time. The time, 10 bytes long, has the following 
form: 

MMddhhmmyy 

where MM is the month, dd is the day, hh is the hour, mm is the 
minute, and yy is the last two digits of the year. For example, the time: 

0826150389 

is 15:03 (3:03 PM) on August 26, 1989. 

Files 



/dev/clock 

See Also 



setclock(ADM) 
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core 

format of core image file 
Description 



The Operating System writes out a core image of a terminated process 
when any of various errors occur. See signal(S) for the list of reasons; 
the most common are memory violations, illegal instructions, bus 
errors, and user-generated quit signals. The core image is called core 
and is written in the process’ working directory (provided it can be; 
normal access controls apply). A process with an effective user ID 
different from the real user ID will not produce a core image. 

The first section of the core image is a copy of the system’s per-user 
data for the process, including the registers as they were at the time of 
the fault. The size of this section depends on the parameter usize, 
which is defined in /usr/include/sys/param.h. The remainder 
represents the actual contents of the user’s core area when the core 
image was written. If the text segment is read-only and shared, or 
separated from data space, it is not dumped. 

The format of the information in the first section is described by the 
user structure of the system, defined in /usr/include/sys/user.h. The 
locations of registers, are outlined in /usr/include/sys/reg.h. 

See Also 



adb(CP), setuid(S), signal(S) 
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cpio 

format of cpio archive 

Description 



The header structure, when the -c option of cpio(C) is not used, is: 



struct { 

short 

ushort 

short 

char 

} Hdr; 



h_magic, 

h_de V ; 

h_ino, 

h_mode, 

h_uid, 

h_gid; 

h_nlink, 

h_rdev, 

h_mtime [2 ] , 

h_namesize, 

h_f ilesize [2] ; 

h_name [ h_name size 



rounded to word] ; 



When the -c option is used, the header information is described by: 



sscanf (Chdr , "%6o%6o%6o%6o%6o%6o%6o%6o%lllo%6o%lllo%s”, 

&Hdr .h_inagic, &Hdr.h_dev, &Hdr.h_ino, &Hdr.h_mode, 
&Hdr.h_uid, &Hdr.h_gid, &Hdr .h_nlink, &Hdr.h_rdev, 
SLongtime, &Hdr .h_namesize, &Longfile, Hdr .h_name) ; 

Longtime and Longfile are equivalent to Hdr.hjntime and 
Hdr.h Jilesize , respectively. The contents of each file are recorded in 
an element of the array of varying length structures, archive , together 
with other items describing the file. Every instance of hjnagic con- 
tains the constant 070707 (octal). The items h dev through hjntime 
have meanings explained in stat(S), The length of the null-terminated 
path name hjtame , including the null byte, is given by hjtamesize . 

The last record of the archive always contains the name TRAILER!!!. 
Special files, directories, and the trailer are recorded with h Jilesize 
equal to zero. 

See Also 



cpio(C), find(C), stat(S) 
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Standards Conformance 



cpio is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 



CPIO(F) 
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default 

default program information directory 
Description 



The files in the directory /etc/default contain the default information 
used by system commands such as xbackup(ADM) and remote(C). 
Default information is any information required by the command that 
is not explicitly given when the command is invoked. 

The directory may contain zero or more files. Each file corresponds to 
one or more commands. A command searches a file whenever it has 
been invoked without sufficient information. Each file contains zero 
or more entries which define the default information. Each entry has 
the form: 

keyword 



or 



keyword=value 

where keyword identifies the type of information available and value 
defines its value. Both keyword and value must consist of letters, 
digits, and punctuation. The exact spelling of a keyword and the ap- 
propriate values depend on the command and are described with the 
individual commands. 

Any line in a file beginning with a number sign (#) is considered a 
comment and is ignored. 

Files 



/etc/default/* 

See Also 



archive(F), xbackup(ADM), boot(HW), cron(C), dos(C), dumpdir(C), 
filesys(F), login(M), Ipr(C), mapchan(M), mapchan(F), micnet (F), 
authsh(ADM) remote(C), xrestore(ADM), su(C), tar(C) 
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Note 



DEFAULT (F) 



Not all commands use /etc/default files. Please refer to the manual 
page for a specific command to determine if /etc/default files are 
used, and what information is specified. 

Value Added 



default is an extension of AT&T System V provided by the Santa Cruz 
Operation. 
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devices 

format of UUCP devices file 

Description 



The Devices file (/usr/Iib/uucp/Devices) contains information for all 
the devices that can be used to establish a link to a remote computer. 
These devices include automatic call units, direct links, and network 
connections. This file works closely with the Dialers, Systems, and 
Dialcodes files. 

Each entry in the Devices file has the following format: 
type ttyline dialerline speed dialer-token 



where: 



type 


can contain one of two keywords (direct or ACU), 
the name of a Local Area Network switch, or a sys- 
tem name. 


ttyline 


contains the device name of the line (port) associ- 
ated with the Devices entry. For example, if the 
Automatic Dial Modem for a particular entry is 
attached to the /dev/ttyll line, the name entered in 
this field is ttyll. 


dialerline 


is useful only for 801 type dialers, which do not 
contain a modem and must use an additional line. 
If you do not have an 801 dialer, enter a hyphen (-) 
as a placeholder. 


speed 


is the speed or speed range of the device. It may 
contain an indicator for distinguishing different 
dialer classes. 



dialer-token contains pairs of dialers and tokens. Each 
represents a dialer and an argument to be passed to 
it. The dialer portion can be the name of an 
automatic dial modem, or it may be a direct for a 
direct link device. 

For best results, dialer programs are preferred over Dialers entries. 

The following entry is an example of an entry using a dialer binary: 

ACU ttynn - 300-2400 /usr/lib/uucp/dialHA24 
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Note all lines must have at least 5 fields. Use for unused fields. 
Types that appear in the 5th field must be either built-in functions 
(801, Sytek, TCP, Unetserver, DK) or standard functions whose name 
appears in the first field in the Dialers file. 

Two escape characters can be used in this file: 

\D which means don’t translate the phone /token 

\T translate the phone /token using the Dialcodes file 

Both refer to the phone number field in the Systems file (field 5). \D 
should always be used with entries in the Dialers file, since the 
Dialers file can contain a T to expand the number if necessary. \T 
should only be used with built-in functions that require expansion. 

Note that if a phone number is expected and a\D or\T is not present a 
\T is used for a built-in, and \D is used for an entry referencing the 
Dialers file. 

Examples 



The following are examples of common Devices files. 



Standard modem line 

ACU ttyOO -- 1200 801 

ACU ttyOO - 1200 penril 

or 

ACU ttyOO - 1200 penril \D 

A direct line 

This example will allow cu -IttyOO to work. This entry could also be 
used for certain modems in manual mode. 

Direct ttyOO - 4800 direct 

A ventel modem on a develcon switch 

“vent” is the token given to the develcon to reach the ventel modem. 

ACU ttyOO - 1200 develcon vent ventel 

ACU ttyOO - 1200 develcon vent ventel \D 

To reach a system on the local develcon switch 

Develcon ttyOO - Any develcon \D 
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A direct connection to a system 



systemx ttyOO - Any direct 

STREAMS Network Examples 

A STREAMS network that conforms to the AT&T Transport Interface 
with a direct connection to login service (i.e., without explicitly using 
the Network Listener Service dial script): 

networkx,eg devicex - - TLIS \D 

The Systems file entry looks like: 



systemx Any networkx - addressx in: — in: nuucp word: nuucp 



You must replace systemx, networkx, addressx, and devicex with sys- 
tem name, network name, network address arid network device, 
respectively. For example, entries for machine “sffo” on a STAR- 
LAN NETWORK might look like: 

sffoo Any STARLAN - sffoo in: — in: nuucp word: nuucp 



and: 



STARLAN, eg starlan - - TLIS \D 

To use a STREAMS network that conforms to the AT&T Transport 
Interface and that uses the Network Listener Service dial script to 
negotiate for a server: 

networkx, eg devicex -- - TLIS \D nls 

To use a non-STREAMS network that conforms to the AT&T Trans- 
port Interface and that uses the Network Listener Service dial script to 
negotiate for a server: 

networkx, eg devicex - - TLI \D nls 

See Also 



uucico(ADM), uucp(C), uux(C), uuxqt(C), dialers(F) 

Notes 



Blank lines and lines that begin with a <space>, <tab>, or are 
ignored, protocols can be sj^cified as a comma-subfield of the device 
type either in the Devices file (where device type is field 1) or in the 
Systems file (where it is field 3). 
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dialcodes 

format of UUCP Dialcode abbreviations file 

Description 



The Dialcodes file (/usr/lib/uucp/Dialcodes) contains the Dialcode 
abbreviations that can be used in the Phone field of the Systems file. 
This feature allows you to create a standard Systems file for distribu- 
tion among several sites that have different phone systems and area 
codes. 

If two remote sites in a network need to link with the same sites, but 
have different internal phone systems each site can share the same 
Systems file, but have different entries in a Dialcodes file. Each entry 
has the following format: 

abb dial-seq 



where: 

abb is the abbreviation used in the Systems file phone 

field 

dial’Seq is the dial sequence that is passed to the dialer 
when that particular Systems file entry is accessed. 

The following entry would be set up to work with a phone field in the 
Systems file such as jt7867 : 

jt 9=847- 

When the entry containing jt7867 is encountered, the following 
sequence is sent to the dialer if the token in the dialer-token-pair is \T 



9=847-7867 

The phone number is made up of an optional alphabetic abbreviation 
and a numeric part. If an abbreviation is used, it must be one that is 
listed in the Dialcodes file. 

NY 9=1212555 

See Also 



uucico(ADM), uucp(C), uux(C), uuxqt(C), systems(F) 
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dialers 

format of UUCP Dialers file 
Description 



The Dialers file (/usr/lib/uucp/Dialers) specifies the initial conversa- 
tion that must take place on a line before it can be made available for 
transferring data. This conversation is usually a sequence of ASCII 
strings that is transmitted and expected, and it is often used to dial a 
phone number using an ASCII dialer (such as the Automatic Dial 
Modem). 

A modem that is used for dialing in and out may require a second 
Dialers entry. This is to reinitialize the line to dial-in after it has been 
used for dial-out. The name of the dial-in version of a dialer must 
begin with an ampersand. For example, the Dialers file contains a 
hayes2400 and a &hayes2400 entry. 

The fifth field in a Devices file entry is an index into the Dialers file 
or a special dialer type. Here an attempt is made to match the fifth 
field in the Devices file with the first field of each Dialers file entry. 
In addition, each odd numbered Devices field starting with the seventh 
position is used as an index into the Dialers file. If the match 
succeeds, the Dialers entry is interpreted to perform the dialer nego- 
tiations. Each entry in the Dialers file has the following format: 

dialer substitutions expect-send ... 

The dialer field matches the fifth and additional odd numbered fields 
in the Devices file. The substitutions field is a translate string: the 
first of each pair of characters is mapped to the second character in the 
pair. This is usually used to translate = and - into whatever the dialer 
requires for “wait for dialtone” and “pause.” 

The remaining expect-send fields are character strings. Below are 
some character strings distributed with the UUCP package in the 
Dialers file. 
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Dialers file entries 


penril 


=W-P 


\d > s\p9\c )-W\p\r\ds\p9\c-) y\c : \E\TP > 9\c OK 


ventel 


=&-% 


"" \r\p\r\c $ <K\T%%\r>\c ONLINE! 


hayes 




\dftT\r\c OC\r \EATDT\T\r\c CONNECT 


rixon 


=&-% 


"" \d\r\r\c $ s9\c ) -W\r\ds9\c-) s\c : \T\r\c $ 9\c LINE 


vadiac 


=«-K 


"" \005\p *-\005\p-*\005\p-* D\p BER? \E\T\e \r\c LINE 


develcon 




\pr\ps\c est:\007 \E\D\e \007 


ndcc*n 

direct 




"" \s\c NAME? \D\r\c GO 


att2212c 


=f-. 


"" \r\c : — : atol2=y,T\T\r\c red 


att4000 


"" \033\r\r\c DEM: \033s0401\c \006 \033s0901\c \ 
\006 \033sl001\c \006 \033sll02\c \006 \033dT\T\r\c \006 


att2224 




"" \r\c : — : T\T\r\c red 


nls 




"" NIPS: 000: 001 :l\N\c 



The meaning of some of the escape characters (those beginning with 
“\”) used in the Dialers file are listed below: 

\p pause (approximately 14 to !4 second) 

\d delay (approximately 2 seconds) 

\D phone number or token without Dialcodes translation 

\T phone number or token with Dialcodes translation 

\K insert a BREAK 

\E enable echo checking (for slow devices) 

\e disable echo checking 

\ r carriage return 

\c no new-line or carriage return 

\n send new-line 

\nnn send octal number. 

Additional escape characters that may be used are listed in the section 
discussing the Systems file. 

The penril entry in the Dialers file is executed as follows. First, the 
phone number argument is translated, replacing any = with a W (wait 
for dialtone) and replacing any - with a P (pause). The handshake 
given by the remainder of the line works as follows: 

" " Wait for nothing. 

\d Delay for 2 seconds. 

> Wait for a >. 
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s\p9\c Send an s, pause for Vi second, send a 9, 

send no terminating new-line 

) -w\p\r\ds\p9\c-) Wait for a ). If it is not received, process 
the string between the - characters as 
follows. Send a W, pause, send a 
carriage-return, delay, send an s, pause, 
send a 9, without a new-line, and then 
wait for the ). 

y\c Send ay. 

Wait for a:. 

\E\TP Enable echo checking. (From this point 

on, whenever a character is transmitted, 
it will wait for the character to be 
received before doing anything else.) 
Then, send the phone number. The \T 
means take the phone number passed as 
an argument and apply the Dialcodes 
translation and the modem function 
translation specified by field 2 of this 
entry. Then send a P. 

> Wait for a >. 



9 \ c Send a 9 without a new-line. 

OK Waiting for the string OK. 



See Also 



dial(ADM), uucico(ADM), uucp(C), uux(C), uuxqt(C), devices(F) 

Notes 



Dialer binaries (located in /usr/lib/uucp) are preferred over Dialers 
entries. Binaries are more reliable. Refer to the dial man page for 
more information on creating your own dialer binaries. 
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dir 

format of a directory 
Syntax 

#include <sys/dir.h> 

Description 



A directory behaves exactly like an ordinary file, except that no user 
may write into a directory. The fact that a file is a directory is indi- 
cated by a bit in the flag word of its inode entry (see filesystem (F)). 
The structure of a directory is given in the include , file 
/usr/include/sys/dir.h. 

By convention, the first two entries in each directory are“dot” (.) and 
“dotdot” (..)• The first is an entry for the directory itself. The second 
is for the parent directory. The meaning of dotdot is modified for the 
root directory of the master file system; there is no parent, so dotdot 
has the same meaning as dot. 

See Also 



filesystem(F) 
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dirent 

filesystem-independent directory entry 

Syntax 

#include <sys/types.h> 

#include <sys/dirent.h> 

Description 



Different file system types may have different directory entries. The 
dirent structure defines a file- system-independent directory entry, 
which contains information common to directory entries in different 
file system types. A set of these structures is returned by the 
getdents (S) system call. 

The dirent structure is defined below. 

struct dirent { 

long d_ino; 

off_t d_off; 

unsigned short d_reclen; 

char d_naine[l]; 

}; 



The djno is a number which is unique for each file in the file system. 
The field d_off is the offset of that directory entry in the actual file 
system directory. The field djiame is the beginning of the character 
array giving the name of the directory entry. This name is null ter- 
minated and may have at most MAXNAMLEN characters. This 
results in file system independent directory entries being variable 
length entities. The value of d reclen is the record length of this 
entry. This length is defined to be the number of bytes between the 
current entry and the next one, so that it will always result in the next 
entry being on a long boundary. 

Files 



/usr/include/sys/dirent.h 

See Also 



getdents(S) 
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Standards Conformance 



dirent is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 



DIRENT (F) 
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filehdr 

file header for common object files 
Syntax 

#include <filehdr.h> 

Description 



Every common object file begins with a 20-byte header. The follow- 
ing C struct declaration is used: 



filehdr 






unsigned short 


f_magic ; 


/* magic number */ 


unsigned short 


f_nscns ; 


/* nunber of sections */ 


long 


f_timdat ; 


/* time & date stanp */ 


long 


f_synptr ; 


/♦ file ptr to symtab */ 


long 


f_nsyms ; 


/* # symtab entries */ 


unsigned short 


f_opthdr ; 


/* sizeof (opt hdr) */ 


unsigned short 


f_flags ; 


/* flags */ 



F_symptr is the byte offset into the file at which the symbol table can 
be found. Its value can be used as the offset mfseekiS) to position an 
I/O stream to the symbol table. The UNIX system optional header is 
28-bytes. The valid magic numbers are given below: 



#define 

#define 

#define 

#define 

#define 

#define 



I286SMAGIC 0512 /* 80286 coirputers-small model 
programs */ 

I286I1^GIC 0522 /* 80286 conputers-large model 
programs */ 

I386MAGIC 0514 /* 80386 corrputers */ 

FBQMAGIC 0560 /* 3B2 and 3B15 conputers */ 
N3BMAGIC 0550 /* 3B20 conputer */ 

NTVMAGIC 0551 /* 3B20 coirputer */ 



#define VAXWRMAGIC 
#define VAXRQMAGIC 



0570 /* VAX writable text segments */ 
0575 /* VAX read only sharable 
text segments */ 



The value in fjimdat is obtained from the time (S) system call. 
Flag bits currently defined are: 

#define F__RELFLG 0000001 /* relocation entries stripped */ 



March 15, 1989 



FILEHDR-1 







FILEHDR(F) 



FILEHDR (F) 



♦define F_EXEC 0000002 /* file is executable */ 

♦define F_LNNO 0000004 /* line nxOTibers stripped */ 

♦define F_LSYMS 0000010 /* local syitibols stripped */ 

♦define F_MINMAL 0000020 /* minimal object file */ 

♦define FJUPDATE 0000040 /* update file, ogen produced */ 
♦define F_SWABD 0000100 /* file is **pre~ swabbed" ♦/ 

♦define F_AR16WR 0000200 /* 16-bit DEC host */ 

♦define F_AR32WR 0000400 /* 32-bit DEC host */ 

♦define F_AR32W 0001000 /* non-DEC host */ 

♦define F_PATCH 0002000 /* **patch" list in opt hdr */ 

♦define F_80186 010000 /* contains 80186 instructions */ 

♦define F_80286 020000 /* contains 80286 instructions */ 

♦define FJBM32ID 0160000 /* WE32000 family ID field */ 

♦define F_BM32B 0020000 /♦ file contains WE 32100 code */ 
♦define FJBM32MAU 0040000 /* file reqs MAU to execute */ 
♦define F_BM32RST 0010000 /* this object file contains restore 

work ciround [3B15/3B2 only] */ 

See Also 



time(S), fseek(S), a.out(F) 
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filesys 

default information for mounting filesystems 

Description 

The /etc/default/filesys file contains information for mounting filesys- 
terns in the following format: 

name=value [name=value] ... 

value may contain white spaces if quoted, and newlines may be 
escaped with a backslash. 

mnt(C) and sysadmsh( ADM) use the information in the 
/etc/default/filesys when the system comes up multiuser. The follow- 
ing names are defined for /etc/default/filesys: 

bdev Name of the block interface device. 

cdev Name of the character interface device. 

size Size in blocks. 

mountdir Directory on which the filesystem is mounted. 

desc A description of the filesystem. For example, 

“User filesystem." 

mountflags Any flags passed to the mount(ADM) command. 

fsckflags Any flags passed to the/^cA:(ADM) command. 

remount Whether or not to mount the filesystem when the 

system goes multiuser. Can be yes, no, or prompt. 
If set to prompt, you are prompted when it is time 
to mount the filesystem. 

See Also 

mount(ADM), mnt(C), sysadmsh(ADM) 
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filesystem 

format of filesystem types 

Syntax 

#include <sys/fs/??filsys.h> 
#include <sys/types.h> 
#include <sys/param.h> 

Description 



Every filesystem storage volume (for example, a hard disk) has a com- 
mon format for certain vital information. Every such volume is 
divided into a certain number of 1024-byte blocks. There are four 
fileystem types available: 

S51K (UNIX fileystem) 

XENIX 

AFS (ACER Fast Filesystem) 

DOS 

The DOS filesystem is a 512-byte filesystem. (The DOS filesystem 
structure is shown in /usr/include/fs/dosfilsys.h. This page does not 
discuss the format of the DOS filesystem in detail. Consult a DOS 
reference for more information.) 

Block 0 is unused and is available to contain a bootstrap program or 
other information. 

Block 1 is the super-block. The format of the S51K, AFS, and XENIX 
filesystem super-blocks are described in two files in the directory 
/usr/include/fs: sSfilsys.h (S5 IK and AFS), xxfilsys.h (XENIX). The 
XENIX filesystem boot block is 1024-bytes; the S51K and UNIX boot 
blocks are 512-byte blocks. In these include files, sjsize is the 
address of the first data block after the i-list. The i-list starts just after 
the super-block in block 2; thus the i-list is sjsize -2 blocks long. 
sjsize is the first block not potentially available for allocation to a 
file. These numbers are used by the system to check for bad block 
numbers. If an “impossible” block number is allocated from the free 
list or is freed, a diagnostic is written on the console. Moreover, the 
free array is cleared so as to prevent further allocation from a presum- 
ably corrupted free list. 

The free list for S51K and XENIX volumes (but not AFS) is main- 
tained as follows: The sjree array contains, in sjree[\], ..., 
sJreelsjifreeA]^ up to NICFREE-1 numbers of free blocks. 
sjree [0] is the block number of the head of a chain of blocks 
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constituting the free list. The first short in each free-chain block is the 
number (up to NICFREE) of free-block numbers listed in the next 
NICFREE longs of this chain member. The first of these NICFREE 
blocks is the link to the next member of the chain. To allocate a 
block: decrement snfree, and the new block is sjree[sjifree]. If 
the new block number is 0, there are no blocks left, so give an error. If 
s nfree becomes 0, read in the block named by the new block number, 
replace s nfree by its first word, and copy the block numbers in the 
next NICFREE longs into the sjree array. To free a block, check if 
s nfree is NICFREE; if so, copy s nfree and the s J^ree array into it, 
write it out, and set s nfree to 0. In any event set sjree[s_nfree] to 
the freed block’s number and increment sjifree . 

In the AFS filesystem, the free list is maintained differently. The AFS 
freelist is organized as a bitmap, one bit per (IK) block in the filesys- 
tem. This organization makes it easy to find contiguous stretches of 
free blocks. 

sjfree is the total free blocks available in the filesystem. 

s_ninode is the number of free i-numbers in the sjnode array. To 
allocate an inode: if s ninode is greater than 0, decrement it and 
return sjnode [s ninode]. If it was 0, read the i-list and place the 
numbers of all free inodes (up to NICINOD) into the sjnode array, 
then try again. To free an inode, provided sjtinode is less than NICI- 
NOD, place its number into sjnode [sjtinode] and increment 
sjiinode. If sjtinode is already NICINOD, do not bother to enter the 
freed inode into any table. This list of inodes only speeds up the allo- 
cation process. The information about whether the inode is really free 
is maintained in the inode itself. 

sjinode is the total free inodes available in the file system. 

The following applies only to S51K and AFS fileystems: s_state indi- 
cates the state of the file system. A cleanly unmounted, not damaged 
file system is indicated by the FsOKAY state. After a file system has 
been mounted for update, the state changes to FsACTIVE. A special 
case is used for the root file system. If the root file system appears 
damaged at boot time, it is mounted but marked FsBAD. Lastly, after 
a file system has been unmounted, the state reverts to FsOKAY. 

s Jlock and sjlock are flags maintained in the core copy of the 
filesystem while it is mounted and their values on disk are immaterial. 
The value of s Jmod on disk is also immaterial, and is used as a flag to 
indicate that the super-block has changed and should be copied to the 
disk during the next periodic update of file system information. 

sj'only is a read-only flag to indicate write-protection. 

sjime is the last time the super-block of the file system was changed, 
and is a double precision representation of the number of seconds that 
have elapsed since 00:00 Jan. 1, 1970 (GMT). During a reboot, the 



March 15, 1989 



FILESYSTEM-2 




FILESYSTEM (F) 



FILESYSTEM (F) 



sjime of the super-block for the root file system is used to set the 
system’s idea of the time. 

I-numbers begin at 1, and the storage for inodes begins in block 2. 
Also, inodes are 64 bytes long, so 16 of them fit into a block. There- 
fore, inode i is located in block (i>31)/16, and begins 
64x((/+31) (mod 16)) bytes from its start. Inode 1 is reserved for 
future use. Inode 2 is reserved for the root directory of the file system, 
but no other i-number has a built-in meaning. Each inode represents 
one file. For the format of an inode and its flags, see inode (F), 

Files 



/usr/include/sys/filsys.h 

/usr/include/sys/stat.h 

See Also 

fsck(ADM), mkfs(ADM), inode(F) 
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fspec 

format specification in text files 
Description 



It is sometimes convenient to maintain text files on the UNIX system 
with non-standard tabs, (i.e., tabs which are not set at every eighth 
column). Such files must generally be converted to a standard format, 
frequently by replacing all tabs with the appropriate number of spaces, 
before they can be processed by UNIX system commands. A format 
specification occurring in the first line of a text file specifies how tabs 
are to be expanded in the remainder of the file. 

A format specification consists of a sequence of parameters separated 
by blanks and surrounded by the brackets <: and :>. Each parameter 
consists of a keyletter, possibly followed immediately by a value. The 
following parameters are recognized: 

itabs The t parameter specifies the tab settings for the file. 
The value of tabs must be one of the following: 

1. a list of column numbers separated by commas, 
indicating tabs set at the specified columns; 

2. a - followed immediately by an integer n, indicat- 
ing tabs at intervals of n columns; 

3. a - followed by the name of a “canned” tab spe- 
cification. 

Standard tabs are specified by t-8, or equivalently, 
tl,9,17,25, etc. The canned tabs which are recognized 
are defined by the tabs{C) command. 

ssize The s parameter specifies a maximum line size. The 
value of size must be an integer. Size checking is per- 
formed after tabs have been expanded, but before the 
margin is prepended. 

mmargin The m parameter specifies a number of spaces to be 
prepended to each line. The value of margin must be an 
integer. 

d The d parameter takes no value. Its presence indicates 

that the line containing the format specification is to be 
deleted from the converted file. 
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e The e parameter takes no value. Its presence indicates 

that the current format is to prevail only until another 
format specification is encountered in the file. 

Default values, which are assumed for parameters not supplied, are t-8 
and mO. If the s parameter is not specified, no size checking is per- 
formed. If the first line of a file does not contain a format specifica- 
tion, the above defaults are assumed for the entire file. The following 
is an example of a line containing a format specification: 

* <:t5, 10,15 s72:> * 

If a format specification can be disguised as a comment, it is not 
necessary to code the d parameter. 

See Also 



ed(C), newform(C), tabs(C) 
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gettydefs 

speed and terminal settings used by getty 

Description 



The /etc/gettydefs file contains infoimation used by getty (M) to set up 
the speed and terminal settings for a line. It supplies information on 
what the login prompt should look like. It also supplies the speed to 
try next if the user indicates the current speed is not correct by typing 
a BREAK character. 

Each entry in /etc/gettydefs has the following format: 

label# initial-flags # final-flags # login-prompt #next-label [# log- 
in-program] 

Each entry must be followed by a carriage return and a blank line. 
The various fields can contain quoted characters of the form \b, \n, \c, 
etc., as well as \nnn, where nnn is the octal value of the desired char- 
acter. The various fields are: 



label This is the string against which getty tries to match 

its second argument. It is often the speed, such as 
1200, at which the terminal is supposed to run, but it 
need not be (see below). 



initial-flags These flags are the initial ioctl (S) settings to which the 
terminal is to be set if a terminal type is not specified to 
getty (M). The flags that getty (M) understands are the 
same as the ones listed in /usr/include/sys/termio.h 
[see termio(M)], Normally only the speed flag is 
required in the initial- flags , getty (M) automatically 
sets the terminal to raw input mode and takes care of 
most of the other flags. The initial- flag settings remain 
in effect until getty (^) executes login(M). 

final-flags Sets the same values as the initial- flags , These flags 
are set just prior to getty executing login-program. The 
speed flag is again required. The composite flag SANE 
is a composite flag that sets the following termio(M) 
parameters: 



modes set: 

CREAD BRKINT IGNPAR ISTRIP ICRNL IXON 
ISIG ICANON ECHO ECHOK OPOST ONLCR 
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modes cleHTod* 

CLOCAL IGNBRK PARMRK INPCK INLCR lUCLC 
IXOFF XCASE ECHOE ECHONL NOFLSH OLCUC 
OCRNL ONOCR ONLRET OHLL OFDEL NLDLY 
CRDLY TABDLY BSDLY VTDLY FFDLY 

The other two commonly specified final-flags are TAB3, 
so that tabs are sent to the terminal as spaces, and 
HUPCL, so that the line is hung up on the final close. 

login-prompt Contains login prompt message that greets users. 

Unlike the above fields where white space is ignored (a 
space, tab, or new-line), it is included in the login- 
prompt field. The in the login-prompt field is 
expanded to the first line (or second line if it exists) in 
/etc/systemid (unless the is preceded by a ‘V)- 
Several character sequences are recognized, including: 



\n 


Linefeed 


\r 


Carriage return 


\v 


Vertical tab 


\nnn 


(3 octal digits) Specify ASCII character 


\t 


Tab 


\f 


Form feed 


\b 


Backspace 



next-label Identifies the next entry in gettydefs for getty to try if 
the current one is not successful. Getty tries the next 
label if a user presses the BREAK key while attempting 
to log in to the system. Groups of entries, for example, 
for dial-up lines or for TTY lines, should form a closed 
set so that getty cycles back to the original entry if 
none of the entries is successful. For instance, 2400 
linked to 1200, which in turn is linked to 300, which 
finally is linked to 2400. 



login-program 

The name of the program that actually logs the user in 
to Altos UNIX System V. The default program is 
/etc/login. If preceded by the keyword AUTO, getty 
will not prompt for a username, but instead uses its first 
argument as the username and executes the login- 
program immediately. 

If getty is called without a second argument, then the first entry of 
/etc/gettydefs is used, thus making the first entry of /etc/gettydefs the 
default entry. The first entry is also used if getty can not find the 
sp^ified label. If /etc/gettydefs itself is missing, there is one entry 
built into the command which will bring up a terminal at 300 baud. 

After modifying /etc/gettydefs, run it through getty with the check 
option to be sure there are no errors. 
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Files 

/etc/gettydefs 

See Also 

stty(C), ioctl(S), getty(M), login(M) 
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gps 

graphical primitive string, format of graphical files 

Description 



GPS is a format used to store graphical data. Several routines have 
been developed to edit and display GPS files on various devices. Also, 
higher level graphics programs such as plot [in stat{\G)] and vtoc [in 
toe (IG)] produce GPS format output files. 

A GPS is composed of five types of graphical data or primitives. 



GPS PRIMITIVES 

lines The lines primitive has a variable number of points from 
which zero or more connected line segments are pro- 
duced. The first point given produces a move to that loca- 
tion. (A move is a relocation of the graphic cursor 
without drawing.) Successive points produce line seg- 
ments from the previous point. Parameters are available 
to set color, weight, and style (see below). 

arc The arc primitive has a variable number of points to 

which a curve is fit. The first point produces a move to 
that point. If only two points are included, a line connect- 
ing the points will result; if three points a circular arc 
through the points is drawn; and if more than three, lines 
connect the points. (In the future, a spline will be fit to 
the points if they number greater than three.) Parameters 
are available to set color, weight, and style. 

text The text primitive draws characters. It requires a single 

point which locates the center of the first character to be 
drawn. Parameters are color, font, textsize, and textangle. 

hardware The hardware primitive draws hardware characters or 
gives control commands to a hardware device. A single 
point locates the beginning location of the hardware 
string. 

comment A comment is an integer string that is included in a GPS 
file but causes nothing to be displayed. All GPS files 
begin with a comment of zero length. 
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GPS PARAMETERS 

color Color is an integer value set for arc^ lines, and text primi- 
tives. 

weight Weight is an integer value set for arc and lines primitives 
to indicate line thickness. The value 0 is narrow weight, 
1 is bold, and 2 is medium weight. 

style Style is an integer value set for lines and arc primitives to 
give one of the five different line styles that can be drawn 
on TEKTRONIX 4010 series storage tubes. They are: 

0 solid 

1 dotted 

2 dot dashed 

3 dashed 

4 long dashed 

font An integer value set for text primitives to designate the 

text font to be used in drawing a character string. 
(Currently /ont is expressed as a four-bit weight value fol- 
lowed by a four-bit style value.) 

textsize Textsize is an integer value used in text primitives to 
express the size of the characters to be drawn. Textsize 
represents the height of characters in absolute universe- 
units and is stored at one- fifth this value in the size- 
orientation (56)) word (see below). 

textangle Textangle is a signed integer value used in text primitives 
to express rotation of the character string around the 
beginning point. Textangle is expressed in degrees from 
the positive x-axis and can be a positive or negative 
value. It is stored in the size-orientation {so) word as a 
value 256/360 of it’s absolute value. 



ORGANIZATION 

GPS primitives are organized internally as follows: 

lines cw points sw 

arc cw points sw 

text cw point sw so [string] 

hardware cw point [string] 

comment cw [string ] 

cw cw is the control word and begins all primitives. It con- 

sists of four bits that contain a primitive-type code and 
twelve bits that contain the word-count for that primitive. 
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point(s) Point{s ) is one or more pairs of integer coordinates. Text 
and hardware primitives only require a single point, 
Point(s ) are values within a Cartesian plane or universe 
having 64K (-32K to +32K) points on each axis. 

sw Sw is the style-word and is used in lines, arc, and text 

primitives. For all three, eight bits contain color informa- 
tion. In arc and lines eight bits are divided as four bits 
weight and four bits style. In the text primitive eight bits 
of sw contain the font. 

so So is the size-orientation word used in text primitives. 

Eight bits contain text size and eight bits contain text 
rotation. 

string String is a null-terminated character string. If the string 
does not end on a word boundary, an additional null is 
added to the GPS file to insure word-boundary alignment. 

See Also 

graphics(ADM), stat(ADM), toc(ADM) 
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group 

format of the group file 

Description 



group contains the following information for each group: 

- Group name 

- Numerical group ID 

- Comma-separated list of all users allowed in the group 

This is an ASCII file. The fields are separated by colons; each group is 
separated from the next by a newline. If the password field is null, no 
password is demanded. 

This file resides in directory /etc. Because of the encrypted pass- 
words, it can and does have general read permission and can be used, 
for example, to map numerical group IDs to names. 

Fiies 



/etc/group 

See Also 



newgrp(C), passwd(C), passwd(F) 

Standards Conformance 



group is conformant with: 

The X/Open Portability Guide II of January 1987; 

IEEE POSIX Std 1003.1-1988 with C Standard Language-Dependent 
System Support; 
and NIST FIPS 151-1. 
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hs 

High Sierra/ISO-9660 CD-ROM filesystem 

Description 



The hs filesystem module supports the mounting of CD-ROM filesys- 
tems conforming the High Sierra/ISO-9660 format. 

Fiies 



/usr/include/sys/fs/hs* 

See Also 



cdrom(HW), mkdev(ADM), mount(ADM) 

Notes 



Since the CD-ROM is a read-only device it is only possible to mount 
CD-ROM filesystems as read-only. The kernel enforces this regardless 
of whether the -r option of mount(ADM) was used when the filesys- 
tem was mounted. 

The command mkdev high-sierra can be used to interactively config- 
ure High Sierra/ISO-9660 filesystem support. 
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inittab, init.base 

script for the init process 

Description 



The inittab file supplies the script to init ’s role as a general process 
dispatcher. The process that constitutes the majority of init ’s process 
dispatching activities is the line process /etc/getty that initiates indi- 
vidual terminal lines. Other processes typically dispatched by init are 
daemons and the shell. 

The inittab file is recreated automatically by idmkinit at boot time 
anytime the kernel has been reconfigured. To construct a new inittab 
file, idmkinit reads the file /etc/conf/cf.d/init.base, which contains a 
base set of inittab entries that are required for the system, and com- 
bines these base entries with add-on entries from the device driver init 
files in the directory /etc/conf/init.d. 

If you add an entry directly to inittab, the change exists only until the 
kernel is relinked. To add an entry permanently, you must also edit 
/etc/conf/cf.d/init.base. The init.base file has the same format as 
inittab. 

The inittab file is composed of entries that are position-dependent and 
have the following format: 

id:rstate:action:process 

Each entry is delimited by a new-line; however, a backslash (\) 
preceding a new-line indicates a continuation of the entry. Up to 512 
characters per entry are permitted. Comments may be inserted in the 
process field using the sh(C) convention for comments. Comments 
for lines that spawn gettys are displayed by the who(C) command. It 
is expected that they will contain some information about the line 
such as the location. There are no limits (other than maximum entry 
size) imposed on the number of entries within the inittab file. The 
entry fields are: 

id This is up to four characters used to uniquely identify an 
entry. 

rstate This defines the run-level in which this entry is to be pro- 
cessed. Run-levels effectively correspond to a configuration 
of processes in the system. That is, each process spawned by 
init is assigned a run-level or run-levels in which it is 
allowed to exist. The run-levels are represented by a number 
ranging from 0 through 6. As an example, if the system is in 
run-level 1, only those entries having a 1 in the rstate field 
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will be processed. When init is requested to change run- 
levels, all processes which do not have an entry in the rstate 
field for the target run-level will be sent the warning signal 
(SIGTERM) and allowed a 20-second grace period before 
being forcibly terminated by a kill signal (SIGKILL). The 
rstate field can define multiple run-levels for a process by 
selecting more than one run-level in any combination from 
0-6. If no run-level is specified, then the process is assumed 
to be valid at all run-levels 0-6. There are three other values, 
a, b, and c, which can appear in the rstate field, even though 
they are not true run-levels . Entries which have these char- 
acters in the rstate field are processed only when the telinit 
[see init(M)] process requests them to be run (regardless of 
the current run-level of the system). They differ from run- 
levels in that init can never enter run-level a, b, or c. Also, a 
request for the execution of any of these processes does not 
change the current run-level . Furthermore, a process started 
by an a, b, or c command is not killed when init changes lev- 
els. They are only killed if their line in /etc/inittab is 
marked off in the action field, their line is deleted entirely 
from /etc/inittab, or init goes into the SINGLE USER state. 

action Key words in this field tell init how to treat the process 
specified in the process field. The actions recognized by init 
are as follows: 

respawn If the process does not exist, then start the pro- 
cess, do not wait for its termination (continue 
scanning the inittab file); and when it dies, res- 
tart the process. If the process currently exists, 
then do nothing and continue scanning the init- 
tab file. 

Upon init's entering the run-level that matches 
the entry’s rstate, start the process and wait for 
its termination. All subsequent reads of the 
inittab file while init is in the same run-lcvcl 
will cause init to ignore this entry. 

Upon init's entering a run-level that matches 
the entry’s rstate , start the process, do not wait 
for its termination. When it dies, do not restart 
the process. If upon entering a new run-level, 
where the process is still running from a previ- 
ous run-level change, the program will not be 
restarted. 

The entry is to be processed only at init ’s boot- 
time read of the inittab file, init is to start the 
process, not wait for its termination; and when it 
dies, not restart the process. In order for this 
instruction to be meaningful, the rstate should 
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boot 
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bootwait 



powerfail 



powerwait 



restart 



off 



ondemand 



initdefault 



be the default or it must match m/r’s run-level 
at boot time. This action is useful for an initial- 
ization function following a hardware reboot of 
the system. 

The entry is to be processed the first time init 
goes from single-user to multi-user state after 
the system is booted. (If initdefault is set to 2, 
the process will run right after the boot.) init 
starts the process, waits for its termination and, 
when it dies, does not restart the process. 

Execute the process associated with this entry 
only when init receives a power fail signal 
[SIGPWR see signal (S)]. 

Execute the process associated with this entry 
only when init receives a power fail signal 
(SIGPWR) and wait until it terminates before 
continuing any processing of inittab. 

Execute the process associated with this entry 
only when init receives a power fail signal 
(SIGPWR) on a warm restart of the system after 
a power failure. 

If the process associated with this entry is 
currently running, send the warning signal 
(SIGTERM) and wait 20 seconds before forci- 
bly terminating the process via the kill signal 
(SIGKILL). If the process is nonexistent, ignore 
the entry. 

This instruction is really a synonym for the 
respawn action. It is functionally identical to 
respawn but is given a different keyword in 
order to divorce its association with run-levels. 
This is used only with the a, b, or c values 
described in the rstate field. 

An entry with this action is only scanned when 
init initially invoked, init uses this entry, if it 
exists, to determine which run-level to enter ini- 
tially. It does this by taking the highest run- 
level specified in the rstate field and using that 
as its initial state. If the rstate field is empty, 
this is interpreted as 0123456 and so init will 
enter run-level 6. Additionally, if init does not 
find an initdefault entry in /etc/inittab, then it 
will request an initial run-level from the user at 
reboot time. 
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sysinit Entries of this type are executed before init tries 
to access the console (i.e., before the Console 
Login: prompt). It is expected that this entry 
will be used only to initialize devices on which 
init might try to ask the run-level question. 
These entries are executed and waited for 
before continuing. 

process This is a sh command to be executed. The entire process 
field is prefixed with exec and passed to a forked sh as sh -c 
'exec command'. For this reason, any legal sh syntax can 
appear in the process field. Comments can be inserted with 
the ; ^comment syntax. 



Files 



/etc/inittab 

/etc/conf/cf.d/init.base 

See Also 



idmkinit(ADM), sulogin(ADM), disable(C), enable(C), getty(M), 
init(M), poweifail(M), restart(M) sh(C), who(C), exec(S), open(S), 
signal(S) 
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inode 

format of an inode 

Syntax 



#include <sys/types.h> 
#include <sys/ino.h> 

Description 



An inode for a plain file or directory in a file system has the structure 
defined by <sys/ino.h>. For the meaning of the defined types offj 
and timej see types (F). 

Fiies 



/usr/include/sy s/ino .h 

See Also 



stat(S), filesystem(F), types(F) 
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issue 

issue identification file 

Description 



The file /etc/issue contains the issue or project identification to be 
printed as a login prompt. This is an ASCII file which is read by pro- 
gram getty and then written to any terminal spawned or respawned 
from the lines file. 

Fiies 



/etc/issue 

See Aiso 



login(M) 
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langinfo 

language information constants 
Syntax 

#include <langinfo.h> 

Description 



This is a header file that contains constants used to identify items of 
nlJanginfo(S) data. (See nlJanginfo(S),) 

The contents of the header file are shown below. 



/★ 

^ LC_CTYPE is not queried through this interface 

★ / 



/* 



★ 

*/ 


LCJSrUMERIC 


items: 






#define 


RADIXCHAR 


2000 


/* 


Decimal separator */ 


tdefine 


THOUSEP 


2001 


/* 


Thousands separator ■ 


/★ 

★ 

#define 


LC_TIME items : 








D_FMT 


3000 


/* 


Date format only */ 


#define 


T_FMT 


3001 


/* 


Time format only */ 


#define 


PM STR 


3002 


/* 


PM */ 


#define 


AM_STR 


3003 


/* 


AM */ 


#define 


D T FMT 


3004 


/* 


Date and time format 


#define 


DAY 1 


3005 


/* 


Sunday */ 


#define 


DAY 2 


3006 


/* 


Monday */ 


#define 


DAY 3 


3007 


/* 


Tuesday */ 


#define 


DAY 4 


3008 


/■k 


Wednesday */ 


#define 


DAY 5 


3009 


/* 


Thursday */ 


tdefine 


DAY 6 


3010 


/* 


Friday */ 


#define 


DAY 7 


3011 




Saturday */ 


tdefine 


ABDAY 1 


3012 


/* 


Sun */ 


tdefine 


ABDAY 2 


3013 


/* 


Mon */ 


tdefine 


ABDAY 3 


3014 


/* 


Tue */ 


tdefine 


ABDAY_4 


3015 


/* 


Wed */ 


tdefine 


ABDAY 5 


3016 


/* 


Thu */ 


tdefine 


ABDAY 6 


3017 


/* 


Fri */ 



March 1 3, 1 990 LANGINFO-1 





LANGINFO (F) 



LANGINFO(F) 



#define 


ABDAY 7 


3018 


/* 


Sat */ 


tdefine MON 1 


3019 


/* 


January */ 


#define 


MON 2 


3020 


/* 


February */ 


#define 


MON 3 


3021 


/* 


March */ 


#define 


MON 4 


3022 


/* 


April */ 


#define 


MON 5 


3023 


/* 


May */ 


#define 


MON 6 


3024 


/* 


June */ 


#define 


MON 7 


3025 


/* 


July */ 


#define 


MON 8 


3026 


/* 


August */ 


#define 


MON 9 


3027 


/* 


September */ 


#define 


MON 10 


3028 


/* 


October */ 


#define 


MON 11 


3029 


/* 


November */ 


#define 


MON_12 


3030 


/* 


December */ 


#define 


ABMON 1 


3031 


/■k 


Jan */ 


#define 


ABMON 2 


3032 


/* 


Feb */ 


#define 


ABMON 3 


3033 


/* 


Mar */ 


#define 


ABMON 4 


3034 


/* 


i^r */ 


#define 


ABMON 5 


3035 


/* 


May */ 


#define 


ABMON 6 


3036 


/* 


Jun */ 


#define 


ABMON 7 


3037 


/* 


Jul */ 


#define 


ABMON 8 


3038 


/* 


Aug */ 


#define 


ABMON 9 


3039 


/* 


Sep */ 


#define 


ABMON 10 


3040 


/* 


Oct */ 


#define ABMON 11 


3041 


/* 


Nov */ 


#define 


ABMON 12 


3042 


/* 


Dec */ 



/* 

* LC_COLLATE is not queried through this interface 

*/ 

/* 

* LC_MESSAGES items : 

*/ 

#define YESSTR 5000 /* Affirmative reply to y/n question */ 

#define NOSTR 5001 /* Negative reply to yes/no question */ 

/* 

* LC_MONETARY items : 

*/ 

#define CRNCYSTR 6000 /* Currency symbol */ 

See Also 



nLtypes(F), nl_langinfo(S) 

Value Added 

langinfo is an extension of AT&T System V provided in Altos UNIX 
System V. 
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Idfcn 



common object file access routines 

Syntax 



#include <stdio.h> 
#include <filehdr.h> 
#include <ldfcn.h> 



Description 



The common object file access routines are a collection of functions 
for reading common object files and archives containing common 
object files. Although the calling program must know the detailed 
structure of the parts of the object file that it processes, the routines 
effectively insulate the calling program from knowledge of the overall 
structure of the object file. 

The interface between the calling program and the object file access 
routines is based on the defined type LDFILE, defined as struct Idfile, 
declared in the header file Idfcn.h. The primary purpose of this struc- 
ture is to provide uniform access to both simple object files and to 
object files that are members of an archive file. 

The function ldopen(S) allocates and initializes the LDFILE structure 
and returns a pointer to the structure to the calling program. The 
fields of the LDFILE structure may be accessed individually through 
macros defined in Idfcn.h and contain the following information: 



LDFILE *ldptr; 

TYPE(ldptr) The file magic number used to distinguish between 
archive members and simple object files. 



lOPTR(ldptr) The file pointer returned by fopen and used by the 
standard input/output functions. 



OFFSET(ldptr) The file address of the beginning of the object file; 

the offset is non-zero if the object file is a member 
of an archive file. 



HEADER(ldptr) The file header structure of the object file. 



The object file access functions themselves may be divided into four 
categories: 



March 1 5, 1 989 



LDFCN-1 







LDFCN (F) 



LDFCN (F) 



(1) functions that open or close an object file 

IdopeniS) and ldaopen[scQ ldopen(S)] 
open a common object file 
ldclose(S) and Idaclose [see ldclose(S)] 
close a common object file 

(2) functions that read header or symbol table information 
ldahread(S) 

read the archive header of a member of an archive file 
ldfhread(S) 

read the file header of a common object file 
ldshread(S) and ldnshread[scc ldshread(S)] 
read a section header of a common object file 
ldtbread(S) 

read a symbol table entry of a common object file 
ldgetname(S) 

retrieve a symbol name from a symbol table entry or from 
the string table 

(3) functions that position an object file at (seek to) the start of the 
section, relocation, or line number information for a particular sec- 
tion. 

ldohseek(S) 

seek to the optional file header of a common object file 
ldsseek(S) and ldnsseek[scc ldsseek(S)] 
seek to a section of a common object file 
ldrseek(S) and ldnrseek[sQC ldrseek(S)] 

seek to the relocation information for a section of a common 
object file 

ldlseek(S) and Idnlseek [see IdlseekiS)] 

seek to the line number information for a section of a com- 
mon object file 
ldtbseek(S) 

seek to the symbol table of a common object file 

(4) the function ldtbindex(S) which returns the index of a particu- 
lar common object file symbol table entry. 

These functions are described in detail on their respective manual 
pages. 

All the functions except ldopen(S), ldgetname{S), IdtbindexiS) return 
either SUCCESS or FAILURE, both constants defined in Idfcn.h. 
Ldopen{S) and ldaopen[{^QQ ldopen{S)\ both return pointers to an 
LDFILE structure. 

Additional access to an object file is provided through a set of macros 
defined in Idfcn.h. These macros parallel the standard input/output 
file reading and manipulating functions, translating a reference of the 



March 15, 1989 



LDFCN-2 




LDFCN (F) 



LDFCN (F) 



LDFILE structure into a reference to its file descriptor field. 

The following macros are provided: 

GETC(ldptr) 

FGETC(ldptr) 

GETW(ldptr) 

UNGETC(c, Idptr) 

FGETS(s, n, Idptr) 

FREAD((char *) ptr, sizeof (*ptr), nitems, Idptr) 

FSEEK(ldptr, ofeet, ptmame) 

FTELL(ldptr) 

REWIND(ldptr) 

FEOF(ldptr) 

FERROR(ldptr) 

HLENO(ldptr) 

SETBUF(ldptr, buf) 

STROFFSET(ldptr) 

The STROFFSET macro calculates the address of the string table. See 
the manual entries for the corresponding standard input/output library 
functions for details on the use of the rest of the macros. 

The program must be loaded with the object file access routine library 
libld.a. 

See Also 



fseek(S), Idahread(S), Idclose(S), Idgetname(S), Idfhread(S), 
Idlread(S), Idlseek(S), Idohseek(S), ldopen(S), Idrseek(S), Idlseek(S), 
Idshread(S), Idtbindex(S), Idtbread(S), Idtbseek(S), stdio(S), intro(M) 

Notes 



The macro FSEEK defined in the header file Idfcn.h translates into a 
call to the standard input/output function fseek{S). FSEEK should not 
be used to seek from the end of an archive file, since the end of an 
archive file may not be the same as the end of one of its object file 
members. 
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limits 

file header for implementation-specific constants 

Syntax 

#include <limits.h> 

Description 



The header file <limits.h> is a list of magnitude limitations imposed 
by a specific implementation of the operating system. All values are 
specified in decimal. 



#define ARG_MAX 
tdefine CHAR_BIT 
#def ine CHAR_MAX 
#def ine CHARJGN 
tdefine CHIID_MAX 
tdefine CIKjrCK 
tdefine DBL_DIG 
tdefine DHL_MAX 
tdefine DHL_MIN 
tdefine FCHR_MAX 
tdefine FIir_DIG 
tdefine FHT_MAX 
tdefine FHTJdlN 
tdefine HUGE_VAL 
tdefine INT_MAX 
tdefine INTJdIN 
tdefine LINK_MAX 
tdefine LONG_MAX 
tdefine LONGJGN 
tdefine Name_MAX 
tdefine CPEN_MAX 
tdefine PASS_MAX 
tdefine PMH_MAX 
tdefine PID_MAX 
tdefine PIPE_BUF 
tdefine PIPE_MAX 
tdefine SHRT_MMC 
tdefine SHRTJfEN 
tdefine STD_BIK 
tdefine SYSJJMLW 
tdefine UID_MAX 
tdefine USI_MAX 
tdefine VOq_BIT 



5120 /* max length of arguments to exec +/ 

8 /♦ t of bits in a "char" */ 

127 /* max integer value of a "char" */ 

-128 /+ min integer value of a "char" +/ 

25 /♦ nax t of processes per user id +/ 

100 /* t of clock ticks per second ♦/ 

16 /* digits of precision of a "double" ♦/ 

1.79769313486231470e+308 /*imx deciiral value of a "double"*/ 
4. 9406564584124 6544e-324 /*min decimal value of a "double"*/ 
1048576 /* rtax size of a file in bytes */ 

7 /* digits of precision of a "float" */ 

3. 4028234 6638528860e+38 /%ax decimal value of a "float" */ 
1.40129846432481707e-45 /*min decimal value of a "float" */ 
3. 4028234 6638528860e+38 /*error value returned by Math lib*/ 
2147483647 /* nax decinal value of an "int" */ 

-2147483648 /* min decimal value of an "int" */ 

1000 /* max t of links to a single file */ 

2147483647/* max decimal value of a "long" */ 

-2147483648 /* min decinal value of a "long" */ 

14 /* nax t of characters in a file name */ 

60 /* rtax t of files a process can have open */ 

8 /* max t of characters in a password */ 

256 /* rtax t of characters in a path name */ 

30000 /* nax value for a process ID */ 

5120 /* rtax t bytes atomic in write to a pipe */ 

5120 /♦ rtax # bytes written to a pipe in a write */ 

32767 /* rtax decimal value of a "short" */ 

-32768 /* min decimal value of a "short" */ 

1024 /* # bytes in a physical I/O block */ 

9 /* # of chars in urame-retumed strings */ 

60000 /* max value for a user or group ID */ 

4294967295/* nax decimal value of an "unsigned" */ 

32 /* # of bits in a "word" or "int" */ 



Standards Conformance 



limits is conformant with: 

The X/Open Portability Guide II of January 1987. 
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linenum 

line number entries in a common object file 

Syntax 

#include <linenum.h> 

Description 



The cc command generates an entry in the object file for each C 
source line on which a breakpoint is possible [when invoked with the 
-g option; see cc(CP)]. Users can then reference line numbers when 
using the appropriate software test system [see sdb(CF)]. The struc- 
ture of these line number entries appears below. 

struct lineno 
{ 

union 

{ 

long 
long 

} 

unsigned short 

} ; 

Numbering starts with one for each function. The initial line number 
entry for a function has IJnno equal to zero, and the symbol table 
index of the function’s entry is in l_symndx. Otherwise, IJnno is 
non-zero, and / _paddr is the physical address of the code for the refer- 
enced line. Thus the overall structure is the following: 



l_symndx ; 
l_paddr ; 
l_addr ; 

1 Inno ; 



function symtab index 


0 


physical address 


line 


physical address 


line 


function symtab index 


0 


physical address 


line 


physical address 


line 


laddr 


IJnno 



See Also 



cc(CP), sdb(CP), a.out(F) 



March 1 5, 1 989 



LINENUM-1 






LOGS (F) 



LOGS (F) 



logs 

MMDF log files 

Syntax 

System status, error, and statistics logging for MMDF 

Description 



MMDF maintains run-time log files at several levels of activity. The 
primary distinction is among message-level, channel-level, and link- 
level information. All logging settings can be overridden by entries in 
the runtime tailor file . In MMDF, that member is merged with 
lusrlmmdfllog to determine the full pathname to the log. Logs are pro- 
tected so that any process may write into them, but only MMDF may 
read them (i.e., 0622). 

The logging files may be the source of some confusion, since the Hog 
package entails some complexity. Its three critical factors are coordi- 
nated access, restricted file length, and restricted verbosity. 

The length of a logging file can be limited to 25-block units. This is 
extremely important since files can grow very long over a period of 
time, especially if there are many long messages sent or very verbose 
logging. 

Restricted verbosity is a way of easily tuning the amount of text 
entered into the log. This is probably the one parameter you need 
most to worry about. Set to full tilt (level=FTR), MMDF get notice- 
ably slower and I/O bound. It also does a pretty good job of showing 
what it is doing and hence helping you figure out the source of errors. 
When you get to trust the code, setting the logging level down is 
highly recommended. The lowest would be TMP or FAT, for tem- 
porary or fatal errors. GEN will log errors and general information. 
FST logs errors, general and statistics information. 
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Specific Logs 

Even with the listed divisions, the logs contain a variety of informa- 
tion. Only the message-level log’s format will be explained in signifi- 
cant detail. 

msg.log records enqueue and dequeue transitions, by submit 

and deliver. Entries by a background deliver pro- 
cess are noted with a “BG-xxxx” tag, where the x’s 
contain the 4 least-significant decimal digits of the 
daemon’s process id. This is to allow distinguishing 
different daemons. When deliver is invoked, by 
submit, for an immediate attempt, the tag begins 
with “DL” rather than “BG”. Entries by submit 
begin with “SB”. 

Every major entry will indicate the name of the message involved. 
Entries from submit will show “lin” if the submission is from a user 
on the local machine. In this case, the end of the entry will show the 
login name of the sender. If the entry is labelled “rin,” then the mail 
is being relayed. The channel name, source host, and sender address 
are shown. Within parentheses, the number of addressees and the 
byte-length of the message are listed. 

Entries from deliver show final disposition of a message/addressee. 
These are indicated by “end.” Then, there is the destination channel 
and mailbox name. In brackets, the queue latency for the address is 
shown in hours, seconds, and minutes. 

chan.log records activity by the channel programs, in 

chndfldir[]. Entries have a tag indicating the type 
of channel making the entry. Different channels 
record different sorts of information. For example, 
the local channel shows when a rcvmail private 
reception program is invoked. 

ph.log is used by the telephone link-level (packet) code. 

ph.tm is the one file that is not size-limited. It records a 

transcript of every character sent and received on a 
telephone channel. It is reset to zero length at the 
beginning of every phone session. It is kept ver- 
bose, in order to facilitate checking the status of 
any telephone channel which is active. Hence, just 
watching for the ph.tm file to get larger can indicate 
that there is progress. Each telephone channel may 
have its own transcript file specified in the channel 
definition in the runtime tailor file. 
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See Also 

mmdf(ADM) 

Value Added 



logs is an extension of AT&T System V provided in Altos UNIX Sys- 
tem V. 
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maildelivery 

user delivery specification file 

Description 



The delivery of mail by the local channel can run through various 
courses, including using a user tailorable file. The delivery follows 
the following strategy, giving up at any point it considers the message 
delivered. 

1) If the address indicates a pipe or file default, then that is car- 
ried out. 

2) The file .maildelivery (or something similar) in the home 
directory is read if it exists and the actions in it are followed. 

3) A system- wide file is consulted next, such as 

/usri lib/ maildelivery and the actions are similar to step 2. 

4) If the message still hasn’t been delivered, then it is put into 
the user’s normal mailbox {.mail or mailbox) depending on 
the system. 

The format of the .maildelivery file is 

field <FS> pattern <FS> action <FS> result <FS> string 
where; 

field is name of a field that is to be searched for a pattern. This 

is any header field that you might find in a message. The 
most commonly used headers are From, to, cc, subject and 
sender. As well as the standard headers, there are some 
pseudo-headers that can also be used. These are: 

source The out-of-band sender information. This is 
the address MMDF would use for reporting 
delivery problems with the message. 

addr the address that was used to mail to you, nor- 

mally youmame or youmame=string (see 
below). 

default if the message hasn’t been delivered yet, this 
field is matched. 
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* this case is always true regardless of any 

other action. 

pattern is some sequence of characters that may be matched in 
the above field. Case is not significant. 

action is one of the mail delivery actions supported by the local 
channel. Currently the supported actions are file or >, 
which appends the message to the given file, with delimit- 
ers; pipe or I, which starts up a process with the message 
as the standard input; and destroy which throws the mes- 
sage away. 

For piped commands, the exit status of the command is 
significant. An exit status of 0 implies that the command 
succeeded and everything went well. An exit status of 
octal 0300-0377 indicates that a permanent failure 
occurred and the message should be rejected. Any other 
exit status indicates a temporary failure and the delivery 
attempt will be aborted and restarted at a later time. 

result is one of the letters A, R or ? which stand for Accept, 
Reject and "Accept if not delivered yet". They have the 
following effects: 

A If the result of this line’s action is OK, then 

the message can be considered delivered. 

R The message is not to be considered delivered 

by this action. 

? This is equivalent to A except that the action 

is not carried out if the message has already 
been accepted. 

The file is always read completely so that several matches can be 
made, and several actions t^en. As a security check, the .mail- 
delivery file must be owned by either the user or root, and must not 
have group or general write permission. In addition the system 
delivery file has the above restrictions but must also be owned by root. 
If the field specified does not need a pattern, a dash (-), or similar sym- 
bol is usually inserted to show that the field is present but not used. 
The field separator character can be either a tab, space or comma (,). 
These characters can be included in a string by quoting them with 
double quotes ("); double quotes can be included with a backslash V 

MMDF treats local addresses which contain an equal sign (’=’) in a 
special manner. Everything in a local address from an equals sign to 
the is ignored and passed on to the local channel. The local chan- 
nel will make the entire string available for matching against the addr 
string of the .maildelivery file. For example, if you were to subscribe 
to a digest as "foo=digest@bar.NET", submit(ADM) and the local 
channel will verify that it is legal to deliver to "foo", but then the 
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entire string "foo=digest” will be available for string matching against 
the .maildelivery file for the addr field. 

Environment 



The environment in which piped programs are run contains a few stan- 
dard features, specifically: 

HOME is set to the user’s home directory. 

USER is set to the user’s login name. 

SHELL is set to the user’s login shell (defaults to /bin/sh). 

The default umask is set up to 077, this gives a very protective crea- 
tion mask. If further requirements are needed, then a shell script can 
be run first to set up more complex environments. 

There are certain built-in variables that you can give to a piped pro- 
gram. These are $( sender), $( address), $(size), $( reply -to) and 
$(info). $( sender) is set to the return address for the message. 
$( address) is set to the address that was used to mail to you, normally 
‘youmame’ or ‘youmame=string’. $(size) is set to the size in bytes of 
this message. $(reply-to) is set to the Reply-To: field (or the From: 
field if the former is missing) and so can be used for automatic replies. 
$(info) is the info field from the internal mail header and is probably 
only of interest to the system maintainers. 

Example 



Here is a rough idea of what a .maildelivery file looks like: 

# lines starting with a '#' are ignored. 

# as are blank lines 

# file mail with mmdf2 in the "To:” line into file rrmdf2.log 
To iTTTdf2 file A ntrKif2.log 

# Messages from nmdf pipe to the program err-message-archive 

From mmdf pipe A err-message-archive 

# Anything with the "Sender:" address "uk-mmdf- workers" 

# file in mmdf2.log if not filed already 

Sender uk-niTKif -workers file ? itTndf2.log 

# "To : " Unix - put in file unix-news 
To Unix > A unix-news 

# if the address is jpo==mn:Kif - pipe into nmdf-redist 
Addr jpo=mmdf 1 A mmdf-redist 

# if the address is jpo=ack - send an acknowledgement copy back 

Addr jpo=ack | R resend -r $ (reply- to) 

# anything from steve - destroy! 
from Steve destroy A - 

# anything not matched yet - put into mailbox 

default - > ? mailbox 

# always run rcvalert 
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R rcvalert 



Files 

$HOME/.maildelivery normal location 

/usr/lib/maildelivery the system file. This 

should be protected. 

The /usr/lib/maildelivery file contains contents such as: 

default - pipe A stdreceive 

* - pipe R ttynotify 

This allows the system to interfaces with non-standard mail systems 
that do not support delimiter-separated mailboxes. 

See Also 

rcvtrip(C) 
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mapchan 

format of tty device mapping files 

Description 



mapchan configures the mapping of information input and output. 

Each unique channel map requires a multiple of 1024 bytes (a IK 
buffer) for mapping the input and output of characters. No buffers are 
required if no channels are mapped. If control sequences are speci- 
fied, an additional IK buffer is required. 

A method of sharing maps is implemented for channels that have the 
same map in place. Each additional, unique map allocates an addi- 
tional buffer. The maximum number of map buffers available on a 
system is configured in the kernel, and is adjustable via the link kit 
NEMAP parameter (see configure {MyM)). Buffers of maps no longer 
in use are returned for use by other maps. 



Example of a Map File 

The internal character set is defined by the right column of the input 
map, and the first column of the output map in place on that line. The 
default internal character set is the 8-bit ISO 8859/1 character set, 
which is also known as dpANS X3.4.2 and ISO/TC97/SC2. It supports 
the Latin alphabet and can represent most European languages. 

Any character value not given is assumed to be a straight mapping, 
only the differences are shown in the mapfile . The left hand columns 
must be unique. More than one occurrence of any entry is an error. 
Right hand column characters can appear more than once. This is 
“many to one” mapping. Nulls can be produced with compose 
sequences or as part of an output string. 

It is recommended that no mapping be enabled on the channel used to 
create or modify the mapping files. This prevents any confusion of the 
actual values being entered due to mapping. It is also recommended 
that numeric rather than character representations be used in most 
cases, as these are not likely to be subject to mapping. Use comments 
to identify the characters represented. Refer to the ascii manual 
page and the hardware reference manual for the device being mapped 
for the values to assign. 
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# 

# sharp/pound/cross-hatch is the coitinent character 

# however, a quoted # ('#') is 0x23, not a comnent 

# 

# beep, input, output, dead, conpose and 

# control are special keywords and should appear as shown. 

# 



beep 


# 


sound the bell when errors occur 


input 






a b 






c d 






dead p 

q r 


# 


p followed by q yields r. 


s t 


# 


p followed by s yields t. 


dead u 






V w 


# 


u followed by v yields w. 


compose x 
y z A 


# 


X is the compose key (only one allowed) . 


BCD 


# 


X followed by B and C yields D. 


output 
e f 


# 


e is mapped to f . 


g h i j 


# 


g is mapped to hij - one to many. 


k 1 m n o 


# 


k is mapped to Imno. 


control 


# 


The control sections must be last 


input 
E 1 


# 


The character E is followed by 1 more 




unmapped character 


output 
FG 2 


# 


The characters FG are followed by 2 



more unmapped characters 



All of the single letters above preceding the “control” section must 
be in one of these formats: 



56 


# decimal 


045 


# octal 


Oxfa 


# hexadecimal 


’b’ 


# quoted char 


^076’ 


# quoted octal 


V4a’ 


# quoted hex 



All of the above formats are translated to single byte values. 

The control sections (which must be the last in the file) contain spe- 
cifications of character sequences which should be passed through to 
or from the terminal device without going through the normal map- 
chan processing. These specifications consist of two parts: a fixed 
sequence of one or more defined characters indicating the start of a 
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no-map sequence, followed by a number of characters of which the 
actual values are unspecified. 

To illustrate this, consider a cursor-control sequence which should be 
passed directly to the terminal without being mapped. Such a 
sequence would typically begin with a fixed escape sequence instruct- 
ing the terminal to interpret the following two characters as a cursor 
position; the values of the following two characters are variable, and 
depend on the cursor position requested. Such a control sequence 
would be specified as: 

\E= 2 # Cursor control: escape = <x> <y> 

There are two subsections under control: the input section is used to 
filter data sent from the terminal to Altos UNIX System V, and the 
output section is used to filter data sent from Altos UNIX System V to 
the terminal. The two fields in each control sequence are separated by 
white space, that is the SPACE or TAB characters. Also the ’#’ 
(HASH) character introduces a comment, causing the remainder of the 
line to be ignored. Therefore, if any of these three characters are 
required in the specification itself, they should be entered using one of 
alternative means of entering characters, as follows: 

y The character produced by the terminal on pressing the CONTROL 
and X keys together. 

\E or\e 

The ESCAPE character, octal 033. 

\c Where c is one of b, f, 1, n, r or t, produces BACKSPACE , FORM 
FEED , LINE FEED , NEWLINE , CARRIAGE RETURN or TAB char- 
acters respectively. 

\0 Since the NULL character can not be represented, this sequence is 
stored as the character with octal value 0200, which behaves as a 
NULL on most terminals. 

\nn or\nnn 

Specifies the octal value of the character directly. 

\ followed by any other character is interpreted as that character. 
This can be used to enter SPACE , TAB , or HASH characters. 
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mapchan performs these error checks when processing the mapfile: 



• More than one compose key. 

• Characters mapped to more than one thing. 

• Syntax errors in the byte values. 

• Missing input or output keywords. 

• Dead or compose keys also occurring in the input section. 

• Extra information on a line. 

• Mapping a character to null. 

• Starting an output control sequence with a character that is 
already mapped. 

If characters are displayed as the 7-bit value instead of the 8-bit value, 
use stty -a to verify that -istrip is set. Make sure input is mapping to 
the 8859 character set, output is mapping from the 8859 to the device 
display character set. dead and compose sequences are input map- 
ping and should be going to 8859. 

Files 



/etc/default/mapchan 

/usr/lib/mapchan/* 

See Also 



ascii(M), keyboard(HW), lp(C), Ipadmin(ADM), mapchan(M), 
trchan(M), mapkey(M), parallel(HW), screen(HW), serial(HW), 
setkey(M), tty(M) 

Notes 



Some non-U.S. keyboards and display devices do not support charac- 
ters commonly used by UNIX command shells and the C programming 
language. Do not attempt to use such devices for system administra- 
tion tasks. 

Not all terminals or printers can display all the characters that can be 
represented using this utility. Refer to the device’s hardware manual 
for information on the capabilities of the peripheral device. 
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Use of mapping files that specify a different “internal” character set 
per-channel, or a set other than the 8-bit ISO 8859 set supplied by 
default can cause strange side effects. It is especially important to 
retain the 7-bit ASCII portion of the character set (see ascii (M)). 
Altos UNIX System V utilities and applications assume these values. 
Media transported between machines with different internal code set 
mappings may not be portable as no mapping is performed on block 
devices, such as tape and floppy drives, trchan can be used to 
“translate” from one internal character set to another. 

Do not set ISTRIP (see stty{C)) on channels that have mapping that 
includes eight bit characters. 

Value Added 



mapchan is an extension of AT&T System V provided in Altos UNIX 
System V. 
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maxuuscheds 

UUCP uusched(ADM) limit file 

Description 



The Maxuuscheds (/usr/lib/uucp/Maxuuscheds) file contains a 
numerical string to limit the number of simultaneous uusched pro- 
grams running. Each uusched running will have one uucico associ- 
ated with it; limiting the number will directly affect the load on the 
system. The limit should be less than the number of outgoing lines 
used by UUCP (a smaller number is often desirable). This file is 
delivered with a default entry of 2. Again, this may be changed to 
meet the needs of the local system. However, keep in mind that the 
load on the system increases with the number of uusched programs 
running. 

See Also 



uucico(ADM), uucp(C), uusched(ADM), uux(C), uuxqt(C) 
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maxuuxqts 

UUCP uuxqt(C) limit file 

Description 



The Maxuuxqts (/usr/lib/uucp/Maxuuxqts) file contains an ASCII 
number to limit the number of simultaneous uuxqt programs running. 
This file has a default entry of 2. If there is a lot of traffic from mail, 
you can increase this number to reduce the time it takes for the mail to 
leave your system. Keep in mind that the load on the system increases 
with the number of uuxqt programs running. 

See Also 



uucico(ADM), uucp(C), uux(C), uuxqt(C) 
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mdevice 

device driver module description file 

Syntax 

/etc/conf/cf.d/mdevice 

Description 



The mdevice file is included in the directory /etc/conf/cf.d. It 
includes a one-line description of each device driver and configurable 
software module in the system to be built [except for file system 
types, see mfsys(F)]. Each line in mdevice represents the Master file 
component from a Driver Software Package (t)SP) either delivered 
with the base system or installed later via idinstall(ADM). 

Each line contains several whitespace-separated fields; they are 
described below. Each field must be supplied with a value or a 
(dash). 

1. Device name: This field is the internal name of the device or 
module, and may be up to 8 characters long. The first character 
of the name must be an alphabetic character; the others may be 
letters, digits, or underscores. 

2. Function list: This field is a string of characters that identify 
driver functions that are present. Using one of the characters 
below requires the driver to have an entry point (function) of the 
type indicated. If no functions in the following list are supplied, 
the field should contain a dash. 

0 - open routine 
c - close routine 
r - read routine 
w - write routine 

1 - ioctl routine 

s - startup routine 
I - init routine 
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h - halt routine 
p - poll routine 
E- enter routine 
P - pre-main init routine 
f - fork routine 
e - exec routine 
X - exit routine 
X - kexit routine 
S - switch routine 
U - restart routine 
D - shut routine 

Note that if the device is a ’block’ type device (see field 3. 
below), a strategy routine and a print routine are required by 
default. 

3. Characteristics of driver: This field contains a set of characters 
that indicate the characteristics of the driver. If none of the 
characters below apply, the field should contain a dash. The 
legal characters for this field are: 

i - The device driver is installable. 

n - The device driver is not installable. 

a - The device driver is automatically installed. 

c - The device is a ’character’ device. 

b - The device is a ’block’ device. 

t - The device is a tty. 

o - This device may have only one sdevice entry. 

r - This device is required in all configurations of the Ker- 
nel. This option is intended for drivers delivered with 
the base system only. Device nodes (special files in the 
Idev directory), once made for this device, are never 
removed. See idmknod. 
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S - This device driver is a STREAMS module. 

H - This device driver controls hardware. This option dis- 
tinguishes drivers that support hardware from those that 
are entirely software (pseudo-devices). 

G - This device does not use an interrupt though an interrupt 
is specified in the sdevice entry. This is used when you 
wish to associate a device to a specific device group. 

D - This option indicates that the device driver can share its 
DMA channel. 

0 - This option indicates that the lOA range of this device 

may overlap that of another device. 

s - Supress device count field. 

N - This device has no driver. 

R - This driver has a reset routine. 

C - This driver allows cluster I/O requests (block device 
only). 

Z - This device may have multiple mdevice{¥) entries. 

1 - This driver ignores pack.d entries. 

4. Handler prefix: This field contains the character string 

prepended to all the externally-known handler routines associ- 
ated with this driver. The string may be up to 4 characters long. 

5. Block Major number: This field should be set to zero in a DSP 
Master file. If the device is a ’block’ type device, a value will 
be assigned by idinstall during installation. 

6. Character Major number: This field should be set to zero in a 
DSP Master file. If the device is a ’character’ type device (or 
’STREAMS’ type), a value will be assigned by idinstall during 
installation. 

7. Minimum units: This field is an integer specifying the minimum 
number of these devices that can be specified in the sdevice file. 

8. Maximum units: This field specifies the maximum number of 
these devices that may be specified in the sdevice file. It con- 
tains an integer. 

9. DMA channel: This field contains an integer that specifies the 
DMA channel to be used by this device. If the device does not 
use DMA, place a ’-1’ in this field. Note that more than one de- 
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vice can share a DMA channel (previously disallowed). 

Specifying STREAMS Devices and Modules 

STREAMS modules and drivers are treated in a slightly different way 
from other drivers in all UNIX systems, and their configuration 
reflects this difference. To specify a STREAMS device driver, its 
mdevice entry should contain both an ’S’ and a ’c’ in the characteris- 
tics field (see 3. above). This indicates that it is a STREAMS driver 
and that it requires an entry in the UNIX kernel’s cdevsw table, where 
STREAMS drivers are normally configured into the system. 

A STREAMS module that is not a device driver, such as a line discip- 
line module, requires an ’S’ in the characteristics field of its mdevice 
file entry, but should not include a ’c’, as a device driver does. 

See Also 

mfsys(F), sdevice(F), idinstall(ADM) 



March 18, 1991 



MDEVICE-4 





MEISA(F) 



MEISA(F) 



meisa 

master EISA system kernel configuration file 

Description 



The meisa file is used by uconfig{ADM) to maintain a mapping 
between EISA hardware functions and UNIX device drivers. Each line 
in the meisa file specifies one such mapping. 

Each line must contain the following five fields, each separated by a 
whitespace: 

dev name flags EISA ID EISA type majors 
Each field is described below: 

dev name This field contains the internal name of the driver. This 
name must match the names in the first field of an mde- 
vice file entry. If this field contains a single dash charac- 
ter (-), then the EISA function specified later in this line 
(in funcjype) will not be mapped to a device driver 
(uconfig will ignore this EISA function). 

flags This field is a string of characters that identify some spe- 
cial driver characteristics. If no flags are specified, the 
field should contain a single dash character (-). The legal 
flag characters are listed below: 

f Indicates that this driver contains an EISA NMI (non- 
maskable interrupt) failure-handling routine. 

i Indicates that there is an associated shell script that 
sets up the I etcIconfUnitdl dev _name file. This shell 
script will be invoked by uconfig with the appropriate 
arguments. 

n Indicates that there is an associated shell script that 
sets up the kid conflnodtAl dev name file. This shell 
script will be invoked by uconfig with the appropriate 
arguments. 

EISAJD This field contains the EISA board ID string that is associ- 
ated with the driver. A full seven-character ID (for exam- 
ple, ACS0201) can be used, but the minor revision num- 
ber may be omitted (for example, ACS02 or ACS020). 
This field is mandatory. 
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EISA type This field contains the EISA function type string that is 
associated with the driver. This string can be a simple 
EISA type (for example, COM,MDC), or may include sub- 
type information (such as COM,ASY;COMl). In addi- 
tion, an abbreviated type string can be used. For example, 
COM,ASY will match both COM,ASY;COMl and 
COM,ASY;COM2 on the specified board. If a type string 
is not defined for the EISA function, the following syntax 
may be used: 

\func_no] 

where func no is the function number of the particular 
EISA board. For example, [5] specifies function 5. For a 
pseudo-driver that does not directly drive a hardware 
function, this field should be a single dash character (-). 

majors This field normally should be 0 (zero), except for drivers 
with multiple major device numbers. In a such a case, 
this field should contain the number of major numbers 
occupied per instance of the hardware function. 

Files 



/etc/conf/cf.d/meisa 

See Also 



uconfig(ADM), mdevice(F), sdevice(F) 

Notes 



No more than one NMI failure handling routine may be specified for 
functions in a single EISA slot. 

Value Added 



meisa is an extension to AT&T UNIX System V provided in Altos 
UNIX System V. 
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mem, kmem 

memory image file 

Description 



The mem file provides access to the computer’s physical memory. 
All byte addresses in the file are interpreted as memory addresses. 
Thus, memory locations can be examined in the same way as individu- 
al bytes in a file. Note that accessing a nonexistent location causes an 
error. 

The kmem file is the same as mem except that it corresponds to ker- 
nel virtual memory rather than physical memory. 

In rare cases, the mem and kmem files may be used to write to mem- 
ory and memory-mapped devices. Such patching is not intended for 
the naive user and may lead to a system crash if not conducted prop- 
erly. Patching device registers is likely to lead to unexpected results 
if the device has read-only or write-only bits. 

Files 



/dev/mem 

/dev/kmem 
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memtune 

table of tunable parameters to be adjusted when add- 
ing more memory 

Description 



The memtune file contains a table of tunable parameters and rules on 
how they should be increased when more memory is added. It is used 
by idmemtune (ADM) to achieve a more efficiently tuned system. 

Each line in memtune must contain the following four fields, each 
separated by whitespace: 

param base increm max 
Each field is described below: 

param This field contains the name of the tunable parameter. 

base This field specifies the value that idememtune {ADM) uses to 

set the base memory configuration. Base memory, by 
default, is 8 megabytes. 

increm This field contains the value added to base for each 4- 
megabyte increase in system memory above the base mem- 
ory configuration. 

max This field specifies the maximum value that the tunable 
parameter param will be set by idmemtune (ADM). 

Files 



/etc/conf/cf.d/memtune 

See Also 



idmemtune(ADM), stune(F), uconfig(ADM) 

Value Added 



memtune is an extension to AT&T System V provided in Altos UNIX 
System V. 
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mfsys 

configuration file for filesystem types 

Syntax 

/etc/conf/cf.d/mfsys 

Description 



The mfsys file contains configuration information for filesystem types 
that are to be included in the next system kernel to be built. It is 
included in the directory /etc/conf/cf.d, and includes a one-line 
description of each filesystem type. The mfsys file is gathered from 
component files in the directory /etc/conf/mfsys.d. Each line contains 
the following whitespace- separated fields: 

1. name: This field contains the internal name for the filesystem 
type (example: S51K, AFS). This name is no more than 32 
characters long, and by convention is composed of uppercase 
alphanumeric characters. 

2. prefix: The prefix in this field is the string prepended to the 
fstypsw handler functions defined for this filesystem type (exam- 
ple: s5) The prefix must be no more that 8 characters long. 

3. flags: The flags field contains a hex number of the form 
“OxNN” to be used in populating ihtfsinfo data structure table 
entry for this filesystem type. 

4. notify flags: The notify flags field contains a hex number of the 
form “OxNN” to be used in population ihe^fsinfo data structure 
table entry for this filesystem type. 

5. function bitstring: function bitstring is a string of 28 zeros 

and ones. Each filesystem type potentially defines 28 functions 
to populate the fstypsw data structure table entry for itself. All 
filesystem types do not supply all the functions in this table, 
however, and this bitstring is used to indicate which of the func- 
tions are present and which are absent. A “1” in this string 
indicates that a function has been supplied, and a “0” indicates 
that a function has not been supplied. Successive characters in 
the string represent successive elements of the fstypsw data 
structure, with the first entry in this data structure represented 
by the rightmost character in the string. 
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See Also 



sfsys(F), idinstall(ADM), idbuild(ADM) 
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micnet 

the Micnet default commands file 

Syntax 

/etc/default/micnet 

Description 



The micnet file lists the system commands that may be executed 
through the remote command. The file is required for each system in 
a Micnet network. Whenever a remote command is received through 
the network, the Micnet programs search the micnet file for the sys- 
tem command specified with the remote command. If found, the com- 
mand is executed. Otherwise, the command is ignored and an error 
message is returned to the system which issued the remote command. 

The file may contain one or more lines. If all commands may be exe- 
cuted, only the line 

executeall 

is required in the file. Otherwise, the commands must be listed indi- 
vidudly. A line that defines an individual command has the form: 

command=commandpath 

Command is the command name to be specified in a remote command. 
Commandpath is the full pathname of the command on the specified 
system. The equal sign (=) separates the command and commandpath. 
For example, the line: 

cat=/bin/cat 

defines the command name cat (used in the remote command) to refer 
to the system command cat in the /bin directory. 

When executeall is set, commands are sought in a series of default 
directories. Initially, the directories are /bin and /usr/bin. The 
default directories can be explicitly defined in the file by including a 
line of the form: 

execpath=PATH=directory[:directory]. .. 
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The first part of the line, execpath=PATH= , is required. Each direc- 
tory must be a valid pathname. The colon is required to separate 
directories. For example, the line: 

execpath=P ATH=/bin :/usr/bin :/usr/bobf A>in 
sets the default directories to /bin, /usr/bin, and /usr/bobf/bin. 

Files 



/etc/default/ micnet 

See Also 



aliases(M), netutil(ADM), systemid(F), top(F) 

Notes 



The rep command cannot be executed from a remote system unless 
the micnet file contains either executeall , or the line 

rcp=/usr/bin/rcp 

Value Added 



micnet is an extension of AT&T System V provided in Altos UNIX 
System V. 
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mmdftailor 

provides run-time tailoring for the MMDF mail router 

Description 



The MMDF mail router reads site-dependent information from the 
ASCII file /usr/mmdf/mmdftailor each time it starts up. 

Keywords in the tailor file are not case-sensitive; however, case is 
important for filenames and similar values. Use quotation marks to 
delimit strings to prevent them from being parsed into separate words 
accidentally. 

The following alphabetical list describes most of the information you 
can set in the mmdftailor file. For information about additional 
channel-specific settings, refer to the documentation about the partic- 
ular channel. 

ALIAS defines an alias table. The following parameters can be used: 

table specifies the name of the table to be associated 
with this alias entry 

trusted allows the entries in the table to cause delivery 
to files and pipes 

nobypass does not allow the ^address alias bypass mecha- 
nism to work on this file 

Here is an example: 

ALIAS table=sysaliases, trusted, nobypass 

AUTHLOG controls authorization information. See MCHANLOG and 
MLOGDIR. 

AUTHREQUEST is the address to which users should mail if they 
have questions about why a message was not authorized for 
delivery. It is also used as the sender of authorization warning 
messages. It is not used if authorization is not enabled on some 
channel. See the auth parameter under MCHN. 

MADDID controls whether submit adds Message-ID: header lines if 
they are missing from messages. It takes a number as an argu- 
ment. If the number is 0, no action is taken. If the number is non- 
zero, then submit adds Message-ID: header lines if they are miss- 
ing from messages. 
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MADDRQ is the address files directory. If it is not a full pathname, it 
is taken relative to MQUEDIR. 

MCHANLOG controls MMDF logging, except for authorization infor- 
mation and information produced by deliver and submit. See also 
MMSGLOG, AUTHLOG, and MLOGDIR. 

Logging files and levels can also be specified in the channel 
descriptions. The logging file, if specified there, overrides the 
MCHANLOG definition. The logging level for the channel is set 
to the maximum of the MCHANLOG level and the channel 
description’s level. The MCHANLOG level can therefore be used 
to increase logging on all channels at once. 

Here is an example: 

MCHANLOG /tmp/mindf chan . log, level=FST, size=40, 
stat=SOME 

An argument without an equal sign is taken as the name of the log. 
Logging levels are: 

FAT logs fatal errors only 

TMP logs temporary errors and fatal errors 

GEN saves the generally interesting diagnostics 

BST shows some basic statistics 

FST gives full statistics 

PTR shows a program trace listing of what is happening 
BTR shows more detailed tracing 

FTR saves every possible diagnostic 

The BTR and FTR conditions are enabled only if you have com- 
piled the MMDF system with DEBUG #define’d. This amount of 
tracing can quickly fill up log files. During normal operation, the 
logging level should be set somewhere between GEN and FST. 

The size parameter is the number of 25 -block units you will allow 
your log file to grow to. When a log file reaches that size, that 
logging either stops or cycles around overwriting old data (see 
cycle). 

The stat parameter sets up various status flags for logging: 

close closes the log after each entry; this allows other pro- 
cesses to write to it as well 

wait if the log is busy, waits a while for it to free 

cycle if the log is at the maximum length specified with 
the size parameter, then cycles to the beginning 



March 13, 1990 



MMDFTAlLOR-2 




MMDFTAILOR (F) 



MMDFTAILOR (F) 



some sets the values dose and wait (the most common 
setting) 

timed opens the log and, after the timeout period (e.g., 5 
minutes), closes the log and reopens it; this option 
overrides all other options (used to reduce the over- 
head of re-opening the log for every entry while still 
retaining the ability to move the log file out from 
under a running process and have the process begin 
logging in the new log file soon thereafter) 

Tailoring of the log files is generally done at the end of the tailor 
file to prevent logging the tailoring action itself, thereby need- 
lessly filling the log files when higher tracing levels are enabled. 
If you have bugs in the tailoring, you can move the log-file tailor- 
ing closer to the top of the tailor file. 

MCHN defines a channel. The following parameters can be used: 

name the name of the channel 

show a display line, which is used for pretty printing 
purposes to explain what the channel is all about 

que the queue directory into which messages for this 
channel should be queued 

tbl the associated table entry of hosts that are accessi- 

ble on this channel; if the specified table has not 
been previously defined, it will be defined with 
the same name, file ^ and show parameters as for 
this channel (do not define two channels that pro- 
cess the same queue, but use different tables 
because it will cause queue structure problems) 

pgm the channel program to invoke for this channel 

mod the mode in which this channel works; if several 
values are selected, they are cumulative: 

reg regular mode (the default); the chan- 
nel must be explicitly invoked by run- 
ning deliver 

host same as reg, but causes deliver to sort 
by host after sorting by channel, 
which allows as many mail messages 
as possible to get sent to a particular 
host before the connection is broken 
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bak channel can be invoked only by the 
background deliver daemon 

psv channel is passive; it is a pickup-type 
channel (e.g., pobox) 

imm channel can be invoked immediately; 
no need to batch up mail 

pick channel can pick up mail from the 
remote host 

send channel can send mail to the remote 
host 

ap the address-parser type to be used for reformatting 
headers on messages going out on this channel; if 
several values are selected, they are cumulative: 

same does not reformat headers 

822 selects RFC822-style source routes 

(e.g.,@A:B@C) 

733 selects %- style (JNT) source routes 
(e.g., B%C@ A) 

big selects NRS hierarchy ordering (for 

the UK) 

nodots selects output of leftmost part of 
domain names (e.g., A in A.B.C) 
for sites that cannot handle 
domains (usually used in conjunc- 
tion with the known- parameter to 
hide domain names behind a smart 
relay) 

jnt is equivalent to 733 combined with 
big 

Iname a name overriding the default MLNAME value for 
this channel (used when the channel should have 
non-standard values for the local domain) 

Idomain a name overriding the default MLDOMAIN value 
for this channel 
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host the name of the host that is being contacted by 
this channel, usually used in the phone and pobox 
channels, or the name of the relay host when all 
mail to hosts in this channel’s table gets relayed to 
one host (this is required on the badusers and 
badhosts pseudo-channels; it must be set to the 
local host for the list channel) 

poll the frequency of polling the remote machine (0 
disables polling, -1 requests polling to be done 
every time the channel is started up, any other 
value is the number of 15-minute intervals to wait 
between polls); if any mail is waiting to be sent, 
this value is ignored because a connection is 
always attempted 

insrc a table of hosts controlling message flow 
outsrc see insrc 

indest see insrc 

outdest see insrc 

known a table of hosts that are known on this channel; be 
sure that the table contains your own fully speci- 
fied host name 

confstr a string used by some channels for specifying the 
invocation of another program 

auth specifies the authorization tests that are made on 

this channel: 



free 


default, no checking takes place 


inlog 


log information for incoming 
messages 


outlog 


log information for outgoing 
messages 


inwam 


warn sender of incoming mes- 
sage if authorization is inade- 
quate (the message still goes 
through) 


outwam 


as inwarn, but for outgoing mes- 
sages 


inblock 


reject incoming messages that 
have inadequate authorization 
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outblock 


as inblock, but for outgoing 
messages 


hau 


host and user authorizations are 
required 


dho 


(direct host only) when applying 
host controls, the message must 
be associated with a user local to 
that host (i.e., no source routes) 



ttl (time-to-live) specifies the number of minutes for 

which retries to a host are blocked when deliver 
detects a connection failure to that host; this value 
can be overridden on the deliver command line 
(default is 2 hours) 

log the name of the channel log file to be used instead 

of the default MCHANLOG 

level the logging level for this channel (see also 
MCHANLCXj) 

Here is a simple example: 

MCHN name=local, que=local, tbl=local, 
show="Local Delivery”, pgm=local, 
poll=0, mod=imm, ap=822, level==BST 

If the first argument does not have an equal sign, the values of the 
name, que, tbl,pgm, and show parameters take on this value. 

MCHNDIR is where the channel programs are to be found. 

MCMDDIR is the default commands directory where the various 
MMDF commands are located. Any command that does not have 
a full pathname is taken relative to this directory. 

MDBM tells MMDF where to find the database file containing the 
associative store. DBM-style databases get their speed and flexi- 
bility by dynamic hashing and can get quite large. By default, the 
file is located in the MTBLDIR directory, but it might need to be 
relocated due to its size. 

MDFLCHAN sets the default channel to something other than local. 

MDLV is the name of the file used for tailoring the delivery for each 
user. 

MDLVRDIR is the directory in which to deliver mail. If this is null, 
then the user’s home directory is used. See also MMBXNAME and 
MMBXPROT. 



March 13, 1990 



MMDFTAILOR-6 




MMDFTAILOR (F) 



MMDFTAILOR (F) 



MDMN defines a domain. The following parameters can be used: 

name an abbreviated name for the domain 

show a display line, which is used for pretty printing pur- 
poses to explain what the domain is all about 

dmn the full name (x.y.z...) of this domain 

table the associated table entry of known sites in this 
domain; if the specified table has not been previ- 
ously defined, it will be defined with the same name, 
file , and show parameters as for this domain 

Here is an example: 

MDMN name="Root", dmn="", show=”Root Domain”, 
table=root domain 



If the first argument does not have an equal sign, the values of the 
name, dmn, and show parameters take on this value. If no table 
parameter is specified, it defaults to the value of the name param- 
eter. 

MFAILTIME is the time a message can remain in a queue before a 
failed-mail message is sent to the sender and the message is 
purged from the queue. See also MWARNTIME. 

MLCKDIR is the directory where the locking of files takes place, this 
is dependent on what style of locking you are doing. 

MLDOMAIN gives your full local domain (this, combined with the 
MLNAME, and possibly the MLOCMACHINE, gives the full net- 
work address). 

MLISTSIZE specifies the maximum number of addresses in a mes- 
sage before it is considered to have a “big” list. If there are more 
than the maximum number of addresses, then MMDF does not 
send a warning message for waiting mail and only returns a “cita- 
tion” for failed mail. A citation consists of the entire header plus 
the first few lines of the message body. 

MLNAME is the name of your machine or site as you wish it to be 
known throughout the network, which can be a generic host name 
used to hide a number of local hosts. If it is a generic host name, 
internal hosts are differentiated by MLOCMACHINE. See also 
MLDOMAIN. 

MLOCMACHINE is the local name of the machine. It is used by a 
site that has several machines, but wants the machines themselves 
to appear as one address. See also MLNAME and MLDOMAIN. 
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MLOGDIR is the default directory in which the log files are kept. See 
also MMSGLOG, AUTHLOG, and MCHANLOG. 

MLOGIN is the user who owns the MMDF transport system. 

MMAXHOPS specifies the maximum number of Received: or Via: 
lines in a message before it is considered to be looping and is 
rejected. 

MMAXSORT controls sorting of messages based on the number of 
messages in the queue. If the number of messages in the queue is 
less then MMAXSORT, the messages are sorted b^y arrival time and 
are dispatched in that order; otherwise, a message is dispatched as 
it is found during the directory search. 

MMBXNAME is the name of the mailbox. If this is null, then the 
user’s login name is used. See also MDLVRDIR and MMBXPROT. 

MMBXPREF is a string written before the message is written into the 
mailbox. It is usually set to a sequence of CTRL- A characters. 
See also MMBXSUFF. 

MMBXPROT gives the protection mode in octal for the user’s mail- 
box. See also MDLVRDIR and MMBXNAME. 

MMBXSUFF is a string written after the message is written into the 
mailbox. It is usually set to a sequence of CTRL- A characters. 
See also MMBXPREF. 

MMSGLOG controls the logging information produced by deliver and 
submit. See also MCHANLOG, AUTHLOG, and MLOGDIR. 

MMSGQ is the directory for the files of message text. If it is not a full 
pathname, it is taken relative to MQUEDIR. 

MPHSDIR is the directory in which the timestamps for the channels 
are made, showing what phase of activity they are in. 

MQUEDIR is the parent directory for the various queues and address 
directories. 

MQUEPROT gives the protection mode in octal that the parent of the 
MQUEDIR directory should have. 

MSIG is the signature that MMDF uses when notifying senders of mail 
delivery problems. 

MSLEEP is the length of time in seconds that the background delivery 
daemon sleeps between queue scans. 
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MSUPPORT is the address to which to send mail that MMDF cannot 
cope with (i.e., that MMDF cannot deliver or return to its sender). 

MTBL defines an alias, domain, or channel table. The following 
parameters can be used: 

name a short name by which the table can be referred to 
later in the file 

file the file from which the contents of the table are built 

show a display line, which is used for pretty printing pur- 
poses to explain what the table is all about 

A typical example might be: 

MTBL name=aliases, f ile=aliases , 
show="User & list aliases” 

If the first argument does not have an equal sign, the values of the 
other parameters take on this value. The following example sets 
the name, file, and show parameters to the string “aliases”, then 
resets the show parameter to the string “Alias table”. 

MTBL aliases, show=”Alias table” 

MTBLDIR is the default directory for the table files. 

MTEMPT is the temporary files directory. If it is not a full pathname, 
it is taken relative to MQUEDIR. 

MWARNTIME specifies the time in hours that a message can remain 
in a queue before a warning message about delayed delivery is 
sent to the sender. See also MFAILTIME. 

UUname defines the UUCP sitename (short form, not full path) and is 
used only by the UUCP channel. See also MLNAME. 

See Also 



dbmbuild(ADM), mmdf(ADM), tables(F), “Setting Up Electronic 
Mail’ ’ in the System Administrator's Guide 

Value Added 



mmdftailor is an extension of AT&T System V provided in Altos 
UNIX System V. 
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mnttab 

format of mounted filesystem table 
Syntax 



#include <stdio.h> 
#include <mnttab.h> 

Description 



The /etc/mnttab file contains a table of devices mounted by the 
mount (ADM) command. 

Each table entry contains the pathname of the directory on which the 
device is mounted, the name of the device special file, the read/write 
permissions of the special file, and the date on which the device was 
mounted. 

The maximum number of entries in mnttab is based on the system 
parameter NMOUNT, which defines the number of allowable mounted 
special files. 

See Also 



mount(ADM) 



March 15, 1989 



MNTTAB-1 








MTUNE (F) 



MTUNE (F) 



mtune 

tunable parameter file 

Syntax 

/etc/conf/cf.d/mtune 

Description 



The mtune file contains information about all the system tunable 
parameters. Each tunable parameter is specified by a single line in the 
file, and each line contains the following whitespace-separated set of 
fields: 

1. parameter name: A character string no more than 20 characters 
long. It is used to construct the preprocessor “#define’s” that 
pass the value to the system when it is built. 

2. default value: This is the default value of the tunable parame- 
ter. If the value is not specified in the stune file, this value will 
be used when the system is built. 

3. minimum value: This is the minimum allowable value for the 
tunable parameter. If the parameter is set in the stune file, the 
configuration tools will verify that the new value is equal to or 
greater than this value. 

4. maximum value: This is the maximum allowable value for the 
tunable parameter. If the parameter is set in the stune file, the 
configuration tools will check that the new value is equal to or 
less than this value. 

The file mtune normally resides in /etc/conf/cf.d. However, a user or 
an add-on package should never directly edit the mtune file to change 
the setting of a system tunable parameter. Instead the idtune com- 
mand should be used to modify or append the tunable parameter to the 
stune file. 

In order for the new values to become effective, the UNIX system ker- 
nel must be rebuilt and the system must then be rebooted. 

See Also 



stune(F), idbuild(ADM), idtune(ADM) 
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mvdevice 

video driver backend configuration file 
Syntax 

/etc/conf/cf.d/mvdevice 

Description 



The mvdevice file accomplishes configurability of video hardware by 
permitting the linking of back ends to the console video driver. This 
linking scheme includes a C library of video back ends for use with 
the link kit and separate driver entries for each of the back ends. 

The configuration program uses the mvdevice file to produce a space.c 
for the console driver. This space.c includes the appropriate include 
files and extern references to the appropriate video back ends. In 
addition, the configuration program builds the console display switch 
with in the space.c. 



The mvdevice file has the following entries: 



prefix 



routine_mask 



type 



oem 



paddr 



name of driver from 1 to 4 characters 
long (for example “mono”) This is the 
name of the video back end. 

This mask tells which routines were sup- 
ported by the particular back end. These 
routines are: vvvinit(), vvvcmos(), 

vvvinitscreenO, vvvscrollQ, vvvcopyQ, 
vvvclearO, vvvpchar(), vvvscurs(), 
vvvsgrO, vvvioctlO, vvvadapctl(). 

This is placed in the file as a literal, for 
example, if the word MONO was put 
into the file, it would include the word 
MONO as the type entry of the adapter 
structure. 

OEM information treated exactly the 
same as the type (i.e. a literal) 

the physical address which the video 
RAM is located. This would allow a 
user to configure a future driver. Also 
included as a literal field. 
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size The size of the video RAM. Also 

included as a literal field. 

This information provides all the basic information needed for the pro- 
gram to generate an appropriate space.c and build the the correct 
adapter switch. 

The routine mask uses the following bits to signify the following rou- 
tines: 



0x0001 vvvinitO 
0x0002 vvvcmosO 
0x0004 vvvinitscreenO 
0x0008 vvvscrollO 
0x0010 vvvcopy() 

0x0020 vvvclearO 
0x0040 vvvpcharQ 
0x0080 vvvscursO 
0x0100 vvvsgrO 
0x0200 vvvioctlO 
0x0400 vvvadapctlO 

The default mvdevice file looks like this: 



# 

# mvdevice: video configuration master file. 

# 

# 



#prefix 


name 


routinestype 


oem 


paddr 


size 




mono 


MONO 


0x07fd 


MONO 


0 


0 


0 


cga 


CGA 


0x07fd 


CGA 


0 


0 


0 


ega 


EGA 


0x07ff 


EGA 


0 


0 


0 


vga 


VGA 


0x07ff 


VGA 


0 


0 


0 



See Also 



sdevice(F) 



March 15, 1989 



MVDEVlCE-2 





NL_TYPES (F) 



NL_TYPES(F) 



nl_types 

data types for native language support 
Syntax 

#include <nl_types.h> 

Description 



This is a header file that provides type definitions used in the native 
language support interface. The types are: 

nMtem 

A type defintion for an item of language data as used by 
nl_langinfo(S). The values for nMtem are defined in the file 
<langinfo.h>. 

nl_catd 

A message catalogue descriptor. (Message catalogues are not 
currently supported.) 

See Also 



langinfo(F), nManginfo(S) 

Value Added 



nljypes is an extension of AT&T System V provided in Altos UNIX 
System V. 
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null 

the null file 

Description 



Data written on a null special file is discarded. 

Reads from a null special file always return 0 bytes. 

Files 

/dev/null 

Standards Conformance 

null is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

and The X/Open Portability Guide II of January 1987. 
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passwd 

the password file 

Description 



The passwd file contains the following information for each user: 
“Login name 
“Numerical user ID 
-Numerical group ID 
-Comment 

-Initial working directory 
-Program to use as shell 

Refer to finger {C) for information in the required format of the com- 
ment field for finger(C) to display the information. Each user is 
separated from the next by a newline. If the password field is null, no 
password is demanded; if the shell field is null, sh(C) is used. 

This file resides in the directory /etc. Encrypted passwords are not 
stored in /etc/pass wd. 

Warning 



Under no circumstances should you edit /etc/passwd with a text edi- 
tor. This will cause a series of error messages to be displayed and 
could prevent any further logins. Use the sysadmsh Accounts selec- 
tion to modify or add user accounts. 

Files 



/etc/passwd 
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See Also 



PASSWD (F) 



login(M), passwd(C), a641(S), getpwent(S), group(F) 

Standards Conformance 



acct is conformant with: 

AT&T S VID Issue 2, Select Code 307- 127; 

The X/Open Portability Guide II of January 1987; 

IEEE POSIX Std 1003.1-1988 with C Standard Language-Dependent 
System Support; 
and NIST FIPS 151-1. 
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permissions 

format of UUCP Permissions file 

Description 



The Permissions file (/usr/lib/uucp/Permissions) specifies the per- 
missions for remote computers concerning login, file access, and com- 
mand execution. In the Permissions file, you can specify the com- 
mands that a remote computer can execute and restrict its ability to 
request or receive files queued by the local site. 

Each entry is a logical line with physical lines terminated by a \ to 
indicate continuation. Entries are made up of options delimited by 
white space. Each option is a name-value pair in the following for- 
mat: 



name=value 

Note that no white space is allowed within an option assignment. 

Comment lines begin with a pound sign (#) and they occupy the entire 
line up to a newline character. Blank lines are ignored (even within 
multi-line entries). 

There are two types of Permissions file entries: 

LOGNAME specifies the permissions that take effect when a 
remote computer calls your computer. 

MACHINE specifies permissions that take effect when your 
computer calls a remote computer. 

Examples 



This entry is for public login. It provides the default permissions. 
Note that use of this type of anonymous login is not encouraged. 

LOGNAME=nuucp \ 

MACHINE=OTHER \ 

READ=/usr/spool/uucppublic \ 
WRITE=/usr/spool/uucppublic \ 

SENDFILES=call REQUEST=no \ 

COMMANDS =/ bin/ rmail 

See Also 



uucico(ADM), uucp(C), uux(C), uuxqt(C) 
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plot 

graphics interface 

Description 



Files of this format are produced by routines described in plot(S) and 
are interpreted for various devices by commands described in 
tplot(ADM), A graphics file is a stream of plotting instructions. Each 
instruction consists of an ASCII letter usually followed by bytes of 
binary information. The instructions are executed in order. A point is 
designated by four bytes representing the x and y values; each value is 
a signed integer. The last designated point in an 1, m, n, or p instruc- 
tion becomes the “current point” for the next instruction. 

Each of the following descriptions begins with the name of the corre- 
sponding routine in plot(S). 

m move: The next four bytes give a new current point. 

n cont: Draw a line from the current point to the point given by the 
next four bytes [see tplot (ADM)]. 

p point: Plot the point given by the next four bytes. 

1 line: Draw a line from the point given by the next four bytes to the 
point given by the following four bytes. 

t label: Place the following ASCII string so that its first character 
falls on the current point. The string is terminated by a new-line. 

e erase: Start another frame of output. 

f linemod: Take the following string, up to a new-line, as the style 
for drawing further lines. The styles are “dotted”, “solid”, 
“longdashed”, “shortdashed”, and “dotdashed”. Effective only 
for the -T4014 and -Tver options of tplot (ADM) (TEK- 
TRONIX 4014 terminal and VERSATEC plotter). 

s space: The next four bytes give the lower left comer of the plot- 
ting area; the following four give the upper right comer. The plot 
will be magnified or reduced to fit the device as closely as possi- 
ble. 

Space settings that exactly fill the plotting area with unity scaling 
appear below for devices supported by the filters of tplot (ADM). The 
upper limit is just outside the plotting area. In every case the plotting 
area is taken to be square; points outside may be displayable on de- 
vices whose face is not square. 
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DASI 300 
DASI 300s 
DASI 450 
TEKTRONIX 4014 
VERSATEC plotter 

See Also 



space(0, 0, 4096, 4096) 
space(0, 0, 4096, 4096) 
space(0, 0, 4096, 4096) 
space(0, 0, 3120, 3120) 
space(0, 0, 2048, 2048) 



plot(S), term(M), graph(ADM), tplot(ADM) 



Notes 



The plotting library plot(S) and the curses library curses (S) both use 
the names erase() and move(). The curses versions are macros. If you 
need both libraries, put the plot(S) code in a different source file than 
the curses (S) code, and/or #undef move() and erase() in the plot(S) 
code. 
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pnch 

file format for card images 

Description 



The PNCH format is a convenient representation for files consisting of 
card images in an arbitrary code. 

A PNCH file is a simple concatenation of card records. A card record 
consists of a single control byte followed by a variable number of data 
bytes. The control byte specifies the number (which must lie in the 
range 0-80) of data bytes that follow. The data bytes are 8-bit codes 
that constitute the card image. If there are fewer than 80 data bytes, it 
is understood that the remainder of the card image consists of trailing 
blanks. 
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poll 

format of UUCP Poll file 
Description 



The Poll file (/usr/lib/uucp/Poll) contains information for polling 
remote computers. Each entry in the Poll file contains the name of a 
remote computer to call, followed by a tab character, and the hours the 
computer should be called. The hours must be integers in the range 
0-23. 



Poll file entries have the following format: 
sysname<YkB>hour ... 

The following entry provides polling of computer gorgon every four 
hours: 



gorgon 0 4 8 12 16 20 

The uudemon.poll script controls polling but does not perform the 
poll. It sets up a polling file (C.sysnxxxx) in the 
lusrispoolluucpinodename directory, where nodename is replaced by 
the name of the machine. This file will in turn be acted upon by the 
scheduler (started by uudemon.hour). The uudemon.poll script is 
scheduled to run semi-hourly before uudemon.hour so that the work 
files will be there when uudemon.hour is called. The default root 
crontab entry for uudemon.poll is as follows: 

1,30 * * * * "/usr/lib/uucp/uudemon . poll > /dev/null" 

See Also 



uucico(ADM), uucp(C), cron(C), crontab(C) 

Standards Conformance 



poll is conformant with: 

AT&TSVID Issue 2, Select Code 307-127. 
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purge 

the policy file of the sanitization utility purge(C) 
Syntax 

/etc/default/purge 

Description 



This file is an ASCII file whose lines each designate a file, filesystem 
or device to be a member of a type. The command: 

purge -t type 

would overwrite all the members of type. 

Blank lines and lines beginning with ‘#’ are ignored. Entries are of the 
form: 



file type [count] 

This specifies that file is a member of type. The optional field count is 
the number of times to overwrite file when it is purged. The default is 
one. 

The two types system and user are hardwired into the purgeiC) util- 
ity. These types can be overwritten with the -s and -u switches to 
purge respectively. 

This file should be configured on site to reflect files and devices 
which are sensitive and need to be protected from unauthorized 
access. 

The initial contents of the file is: 

Amp system 

/user user 



Files 



/etc/default/purge 

See Also 



purge(C), sysadmsh(ADM) 
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Value Added 



PURGE (F) 



purge is an extension of AT&T System V provided in Altos UNIX Sys- 
tem V. 
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queue 

MMDF queue files for storing mail in transit 
Syntax 

/usr/spool/mmdf/lock/home 

Description 



MMDF stores mail in an isolated part of the file system, so that only 
authorized software may access the mail. Mail is stored under the 
directory sub-tree. 

It must specify a path with at least two sub-directories. The next-to- 
bottom one is used as a “locking” directory and the bottom one is the 
home. For full protection, only authorized software can move through 
the locking directory. Hence, it is owned by MMDF and accessible 
only to it. 

Queue Entries 

When mail is queued by submit, it is actually stored as two files. One 
contains the actual message text and the other contains some control 
information and the list of addressees. 

The text file is stored in the msg directory. The other file is stored in 
the ad dr directory and is linked into one or more queue directories. 
The queue directories are selected based on the channels on which this 
message will be delivered. Each output channel typically has its own 
queue directory. 

Another directory below home is a temporary area called tmp. It 
holds temporary address-lists as they are being built. Queuing of a 
message is completed by linking this address file into addr and the 
queue directories. The msg directory contains files with message text. 
Addr and msg files are synchronized by giving them the same unique 
name, which MMDF occasionally calls the message “name”. The 
message name is derived by use of mktemp(S), using msg as the base 
directory. The files created in addr must be open read-write access; 
the ones in msg must be open read access. 

When submit runs, it changes into home for its working directory. It 
then does a setuidQ to run as the caller. This is necessary to permit 
submit to access the caller’s address-list files (specified as “< file”), 
but probably will be changed. Deliver changes into the queue direc- 
tory to minimize the time spent searching for messages to deliver. 
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The following depicts the directory organization: 





lock 


(lock: 0700) 




I 

I 


(mmdf only) 




1 

home 


(open: 0777) 


/■ 


1 1 \ 




/ 


1 1 \ 




tmp 


addr q.* msg 


(open: 0777) 


addresses 


==> moved and linked 


message text 


built here 


==> into here into here 


put here 



entries: 0666 0666 0644 



Queue File Formats 

The msg portion of a queued message simply contains the message, 
which must conform to the Arpanet standard syntax, specified in 
RFC822. It is expected that the format of the message contents file 
eventually will be more structured, permitting storage of multi-media 
mail. 

The following specifies the syntax of the addr (and queue directory) 
address-list portion of the queued message: 



Address File Contents 



file ::= 


creation late flags \n' [rtm-addr] ^n’ 
*(adr_queue \n’) 


creation ::= 


{long integer decimal representation of time 
message was created} 


late ::= 


ADR_MAIL / ADR_DONE (from adr_queue.h) 


flags ::= 


{decimal representation of 16-bits of flags} 


rtm-addr ::= 


{rfc822 return address} 


adr_queue ::= 


temp_ok mode queue host local {conforms to 
structure specified in adr_queue.fi} 


temp_ok ::= 


{temporary flag indicating whether this address 
has l^en verified by the receiving host: “yes” is 
“-H”;“not yet”is“-”} 
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mode ::= 


{send to mailbox(m), tty(t), both(b), either(e), or 
processing completed(*)} 


queue ::= 


(name of the queue into which this message is 
linked for this address} 


host ::= 


(official name (and domain) of recipient host} 


local ::= 


(local address on receiving host} 



Address File Description 

An address queue file contains a creation time-stamp, an indication if 
the sender has been notified of delayed delivery, some flags, an 
optional return-mail address, and an address list. Several <flags> are 
currently in use (as specified in msg.h). ADR_NOWARN indicates 
whether late warnings should be sent to the return-mail address if the 
entire address list has not been processed within the number of hours 
specified by “wamtime”. ADR_NORET indicates whether mail 
should be returned to the sender if it hasn’t been completely processed 
within the number of hours specified by “failtime”. ADR_CITE indi- 
cates whether warning and failure messages are to contain only a cita- 
tion of the message. An ADR_DONE (“*”) value, for the “late” 
flag, indicates that a warning notice has been sent. 

The creation date is coded as a long ASCII decimal string, terminated 
by the “late” flag. This has to be stuffed into the file because Unix 
doesn’t maintain it. The date is used to sort the queue so that mail is 
delivered in the order submitted. 

The return address is a line of text and may be any address acceptable 
to submit. 

Each address entry is on a separate line, and conforms to the 
adr_struct format, defined in adr queue. h. It contains several fields 
separated by spaces or commas. Fields containing spaces or commas 
must be enclosed in double quotes. 

The temp_ok flag indicates whether the address has been accepted 
during an “address verification” dialog with the receiving host. 
When the message text is successfully accepted by the receiving host, 
then this flag no longer applies and the mode is set to ADR_DONE 
(“*”). Before final acceptance of message text, the mode flag indi- 
cates whether the mail is for a mailbox, terminal, both, or either. 
(Currently only mailbox delivery, ADR_MAIL, is used.) 

The queue name is the name of the sub-queue in which the message is 
queued for this address. Each addressee’s host may be on a separate 
queue or some hosts may share the same queue. When all addressees 
in the same queue have been delivered, the address file is removed 
from that queue directory. When all queues have been processed, the 
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address file (in both addr and the queue directory) and the text file (in 
msg) are removed. 

The host and local strings are used by the channel program. The host 
determines the type of connection the channel program makes. The 
local string is passed to the host; it should be something meaningful to 
that host. The local string must not contain newline or null and it be a 
valid local address per RFC822. 

See Also 



deliver(ADM), cleanque(ADM), submit(ADM) 
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queuedefs 

scheduling information for cron queues 

Description 



The queuedefs file is read by the clock daemon, cron, and controls 
how jobs submitted with at, batch, and crontab are executed. Every 
job submitted by one of these programs is placed in a certain queue, 
and the behavior of these queues is defined in 
/usr/lib/cron/queuedefs. Queues are designated by a single, lower- 
case letter. The following queues have special significance: 



a 


at queue 


b 


batch queue 


c 


cron queue 



For a given queue, the queuedefs file specifies the maximum number 
of jobs that may be executing at one time (njobs), the priority at which 
jobs will execute (nice), and the how long cron will wait between 
attempts to run a job (wait). If njobs jobs are already running in a 
given queue when a new job is scheduled to begin execution, cron will 
reschedule the job to execute wait seconds later. A typical file might 
look like this: 

a . 4 jin 

b . 2 j2n90w 

Each line gives parameters for one queue. The line must begin with a 
letter designating a queue, followed by a period ( . ). This is followed 
by the numeric values for njobs, nice, and wait, followed respectively 
by the letters “j”, “n”, and “w”. The values must appear in this 
order, although a value and its corresponding letter may be omitted 
entirely, in which case a default value is used. The default values are 
njobs = 100, nice = 2, and wait = 60. 

The value for nice is added to the default priority of the job (a higher 
numerical priority results in a lower scheduling priority - see nice(C)). 
wait is given in seconds. 

Files 



/usr/lib/cron/queuedefs 



queuedefs file 
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reloc 

relocation information for a common object file 

Syntax 

#include <reloc.h> 

Description 

Object files have one relocation entry for each relocatable reference 
in the text or data. If relocation information is present, it will be in the 
following format. 

struct reloc 
{ 

long r_vaddr ; /* (virtual) address of 

reference */ 

long r_syinndx ; /* index into symbol table */ 

short r_type ; /* relocation type */ 

} ; 

# define RJPCRLONG 024 

As the link editor reads each input section and performs relocation, 
the relocation entries are read. They direct how references found 
within the input section are treated. 

R_PCRLONG A “PC-relative” 32-bit reference to the symbol’s vir- 
tual address. 

More relocation types exist for other processors. Equivalent reloca- 
tion types on different processors have equal values and meanings. 
New relocation types will be defined (with new values) as they are 
needed. 

Relocation entries are generated automatically by the assembler and 
automatically used by the link editor. Link editor options exist for 
both preserving and removing the relocation entries from object files. 

See Also 

as(CP), Id(CP), a.out(F), syms(F) 
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sccsfile 

format of an SCCS file 
Description 



An SCCS file is an ASCII file. It consists of six logical parts: the 
checksum, the delta table (contains information about each delta), 
user names (contains login names and/or numerical group IDs of users 
who may add deltas), (contains definitions of internal keywords), 
comments (contains arbitrary descriptive information about the file), 
and the body (contains the actual text lines intermixed with control 
lines). Each logical part of an SCCS file is described in detail below. 

Throughout an SCCS file there are lines which begin with the ASCII 
SOH (start of heading) character (octal 001). This character is 
hereafter referred to as the control character and will be represented 
graphically as Any line described below which is not depicted as 
beginning with the control character is prevented from beginning with 
the control character. Entries of the form DDDDD represent a five 
digit string (a number between 00000 and 99999). 

Checksum 

The checksum is the first line of an SCCS file. The form of the line is: 
@hDDDDD 

The value of the checksum is the sum of all characters, except those of 
the first line. The @hR provides a magic number of (octal) 064001. 

Delta Table 

The delta table consists of a variable number of entries of the form: 

@s DDDDD/DDDDD/DDDDD 

@d <type> <SCCS ID> yr/mo/da hr:mi:se <pgmr> DDDDD DDDDD 
@i DDDDD ... 

@x DDDDD ... 

@g DDDDD ... 

@m <MR number> 



@c <comments> ... 



@e 
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The first line (@s) contains the number of lines 
inserted/deleted/unchanged respectively. The second line (@d) con- 
tains the type of the delta (currently, normal: D, and removed: R), the 
sees ID of the delta, the date and time of creation of the delta, the 
login name corresponding to the real user ID at the time the delta was 
created, and the serial numbers of the delta and its predecessor, 
respectively. 

The @i, @x, and @g lines contain the serial numbers of deltas 
included, excluded, and ignored, respectively. These lines are 
optional. 

The @m lines (optional) each contain one MR number associated with 
the delta; the @c lines contain comments associated with the delta. 

The @e line ends the delta table entry. 



User Names 

The list of login names and/or numerical group IDs of users who may 
add deltas to the file, separated by new-lines. The lines containing 
these login names and/or numerical group IDs are surrounded by the 
bracketing lines @u and @U. An empty list allows anyone to make a 
delta. 



Flags 

Keywords used internally (see admin(C¥) for more information on 
their use). Each flag line takes the form: 

@f <flag> <optional text> 

The following flags are defined: 

@f t <type of program> 

@f V <program name> 

@f i 
@fb 

@f m <module name> 

@f f <floor> 

@f c <ceiling> 

@f d <default-sid> 

@fn 

@fj 

@fl <lock-releases> 

@f q <user defined> 

The t flag defines the replacement for the identification keyword. 
The V flag controls prompting for MR numbers in addition to com- 
ments; if the optional text is present it defines an MR number validity 
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checking program. The i flag controls the waming/error aspect of the 
“No id keywords” message. When the i flag is not present, this mes- 
sage is only a warning; when the i flag is present, this message will 
cause a “fatal” error (the file will not be gotten, or the delta will not 
be made). When the b flag is present the -b option may be used with 
the get command to cause a branch in the delta tree. The m flag 
defines the first choice for the replacement text of the sccsfile.F iden- 
tification keyword. The f flag defines the “floor” release; the release 
below which no deltas may be added. The c flag defines the “ceil- 
ing” release; the release above which no deltas may be added. The d 
flag defines the default SID to be used when none is specified on a get 
command. The n flag causes delta to insert a “null” delta (a delta 
that applies no changes) in those releases that are skipped when a 
delta is made in a new release (e.g., when delta 5.1 is made after delta 
2.7, releases 3 and 4 are skipped^ The absence of the n flag causes 
skipped releases to be completely empty. The j flag causes get to 
allow concurrent edits of the same base SID. The 1 flag defines a list 
of releases that are locked against editing {get {CP) with the -e option). 
The q flag defines the replacement for the identification keyword. 



Comments 

Arbitrary text surrounded by the bracketing lines @t and @T. The 
comments section typically contains a description of the file’s pur- 
pose. 

Body 

The body consists of text lines and control lines. Text lines don’t 
begin with the control character, control lines do. There are three 
kinds of control lines: insert, delete , and end, as follows: 

@I DDDDD 
@D DDDDD 
@E DDDDD 

The digit string (DDDDD) is the serial number corresponding to the 
delta for the control line. 

See Also 



admin(CP), delta(CP), get(CP), prs(CP) 

Standards Conformance 



sccsfile is conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 
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scnhdr 

section header for a common object file 
Syntax 



#include <scnhdr.h> 

Description 



Every common object file has a table of section headers to specify the 
layout of the data within the file. Each section within an object file 
has its own header. The C structure appears below. 

struct scnhdr 
{ 

char 
long 
long 
long 
long 
long 
long 

unsigned short 
unsigned short 
long 

} ; 

File pointers are byte offsets into the file; they can be used as the 
offset in a call to FSEEK [see ldfcn(¥)]. If a section is initialized, the 
file contains the actual bytes. An uninitialized section is somewhat 
different. It has a size, symbols defined in it, and symbols that refer to 
it. But it can have no relocation entries, line numbers, or data. Conse- 
quently, an uninitialized section has no raw data in the object file, and 
the values for s scnptr, s relptr, s_lnnoptr, sjireloc, and s nlnno are 
zero. 

See Also 



s_nane [SYMNMLEN] ; /* section name */ 
s_paddr; /* physical address */ 

s_vaddr; /* virtual address */ 

s_size; /* section size */ 

s_scnptr; /* file ptr to raw data */ 

s_relptr; /* file ptr to relocation */ 

s_lnnoptr; /* file ptr to line numbers ♦/ 

s_nreloc; /* # reloc entries */ 

s_nlnno; /* # line number entries */ 

s_flags; /* flags ♦/ 



Id(CP), fseek(S), a.out(F) 



March 15, 1989 



SCNHDR-1 






SCR_DUMP(F) 



SCR_DUMP(F) 



scr_dump 

format of curses screen image file 

Syntax 



scr_dump(file) 

Description 



The curses(S) function scr dumpO will copy the contents of the 
screen into a file. The format of the screen image is as described 
below. 

The name of the tty is 20 characters long and the modification time 
(the mtime of the tty that this is an image of) is of the type timej. All 
other numbers and characters are stor^ as chtype (see <curses.h>). 
No new-lines are stored between fields. 

<magic number: octal 0433> 

<name of tty> 

<mod time of tty> 

<columns> <lines> 

<line length> <chars in line>for each line on the screen 
<line length> <chars in line> 



<labels?> 1, if soft screen labels are present 

<cursor row> <cursor column> 

Only as many characters as are in a line will be listed. For example, if 
the <line length> is 0, there will be no characters following <line 
length>. If <labels?> is TRUE, following it will be 

<number of labels> 

<label width> 

<chars in label 1> 

<chars in label 2> 



See Also 



curses(S) 
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sdevice 

local device configuration file 
Syntax 

/etc/conf/cf.d/sdevice 

Description 



The sdevice file contains local system configuration information for 
each of the devices specified in the mdevice file. It contains one or 
more entries for each device specified in mdevice. sdevice is present 
in the directory letciconficf.dy and is coalesced from component files 
in the directory letcl conf I sdevice. d. Files in letciconff sdevice. d are the 
System file components either delivered with the base system or 
installed later via idinstalL 

Each entry must contain the following whitespace- separated fields: 

1. Device name: This field contains the internal name of the driver. 
This must match one of the names in the first field of an mdevice 
file entry. 

2. Configure: This field must contain the character ’Y’ indicating 
that the device is to be installed in the kernel. For testing pur- 
poses, an ’N’ may be entered indicating that the device will not 
be installed. 

3. Unit: This field can be encoded with a device dependent 
numeric value. It is usually used to represent the number of 
subdevices on a controller or pseudo-device. Its value must be 
within the minimum and maximum values specified in fields 7 
and 8 of the mdevice entry. 

4. Ipl: The ipl field specifies the system ipl level at which the 
driver’s interrupt handler will run in the new system kernel. 
Legal values are 0 through 8. If the driver doesn’t have an inter- 
rupt handling routine, put a 0 in this field. 

5. Type: This field indicates the type of interrupt scheme required 
by the device. The permissible values are: 

0 - The device does not require an interrupt line. 

1 - The device requires an interrupt line. 

If the driver supports more than one hardware control- 
ler, each controller requires a separate interrupt. 
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2 - The device requires an interrupt line. 

If the driver supports more than one hardware control- 
ler, each controller will share the same interrupt. 

3 - The device requires an interrupt line. 

If the driver supports more than one hardware control- 
ler, each controller will share the same interrupt. Mul- 
tiple device drivers having the same ipl level can share 
this interrupt. 

6. Vector: This field contains the interrupt vector number used by 
the device. If the Type field contains a 0 (i.e., no interrupt 
required), this field should be encoded with a 0. Note that more 
than one device can share an interrupt number. 

7. SIOA: The SIOA field (Start I/O Address) contains the starting 
address on the I/O bus through which the device communicates. 
This field must be within 0x1 and 0x3fff. (If this field is not 
used, it should be encoded with the value zero.) 

8. EIOA: The field (End I/O Address) contains the end address on 
the I/O bus through which the device communicates. This field 
must be within 0x1 and 0x3fiff. (If this field is not used, it should 
be encoded with the value zero.) 

9. SCMA: The SCMA field (Start Controller Memory Address) is 
used by controllers that have internal memory. It specifies the 
starting address of this memory. This field must be within 
0xa(X)00 and Oxfbfff. (If this field is not used, it should be 
encoded with the value zero.) 

10. ECMA: The ECMA (End Controller Memory Address) specifies 
the end of the internal memory for the device. This field must 
be within 0xa0(X)0 and Oxfbfflf. (If this field is not used, it 
should be encoded with the value zero.) 

See Also 



mdevice(F), idinstall(ADM) 
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sfsys 

local filesystem type file 

Syntax 

/etc/conf/cf.d/sfsys 

Description 



The sfsys file contains local system information about each file sys- 
tem type specified in the mfsys file. It is present in the directory 
letciconficf.d, and contains a one-line entry for each file system type 
specified in the mfsys file. The sfsys file is coalesced from com- 
ponent files in the directory /etc/conf/sfsys.d. Each line in this file is 
a whitespace-separated set of fields that specifies: 

name This field contains the internal name of the file system type 
(e.g., DUFST, S51K). By convention, this name is up to 32 
characters long, and is composed of all uppercase 
alphanumeric characters. 

YIN This field contains either an uppercase “Y” (for “yes”) or an 
uppercase “N” (for “no”) to indicate whether the named file 
system type is to be configured into the next system kernel to 
be built. 

See Also 



mfsys(F), idinstall(ADM), idbuild(ADM) 
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stat 

data returned by stat system call 

Syntax 



#include <sys/stat.h> 

Description 



The sys/stat.h include file contains the definition for the structure 
returned by the stat mid f stat functions. The structure is defined as: 



struct stat{ 








dev_t 


st_dev; 


/* 




ino_t 


st_ino; 


/* 


inode number */ 


ushort 


sh_inode; 


/★ 


file mode */ 


short 


st_nlink; 


/* 


# of links */ 


ushort 


st_uid; 


/* 


owner uid */ 


ushort 


st_gid; 


/* 


owner gid */ 


dev_t 


st_rdev; 


/* 




off_t 


st_size; 


/* 


file size in bytes */ 


time_t 


st_atiine; 


/* 


time of last access */ 


time_t 


st mtime; 


/* 


time of last data modification */ 


time_t 


st_ctime; 


/* 


time of last file status 'change' 



}; 



Note that the st atime , st mtime , md st_ctime values are measured in 
seconds since 00:00:00 (GMT) on January 1, 1970. 
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The St mode value is actually a combination of one or more of the fol- 
lowing file mode values: 



s 


IFMT 


0170000 


/* 


type of file */ 




s 


'iFDIR 


0040000 


/* 


directory */ 




s 


"iFCHR 


0020000 


/* 


character special */ 




s 


Tfblk 


0060000 


/* 


block special '^/ 




s 


JFREG 


0100000 


/★ 


regular */ 




s 


JFIFO 


0010000 


/* 


fifo */ 




s 


"iFNAM 


0050000 


/* 


name special entry */ 




s 


'iNSEM 


01 


/* 


semaphore */ 




s 


"iNSHD 


02 


/* 


shared memory */ 




s 


'iSUID 


04000 


/* 


set user id on execution */ 




s 


"iSGID 


02000 


/* 


set group id on execution 




s 


"iSVTX 


01000 


/★ 


save swapped text even after use 


★/ 


s 


'iREAD 


00400 


/* 


read permission, owner */ 




s 


JWRITE 


00200 


/* 


write permission, owner */ 




s 


^lEXEC 


00100 


/★ 


execute/search permission, owner 


*/ 



Files 



/usr/include/sys/stat.h 

See Also 

stat(S) 

Standards Conformance 



stat is conformant with: 

AT&T SVID Issue 2, Select Code 307-127; 

The X/Open Portability Guide II of January 1987; 

IEEE POSIX Std 1003.1-1988 with C Standard Language-Dependent 
System Support; 
and NIST FIPS 151-1. 
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stune 

local tunable parameter file 

Syntax 

/etc/conf/cf.d/stune 

Description 



The stune file contains local system settings for tunable parameters. 
The parameter settings in this file replace the default values specified 
in the mtune file, if the new values are within the legal range for the 
parameter specified in mtune. The file contains one line for each 
parameter to be reset. Each line contains two whitespace-separated 
fields: 

1. external name: This is the external name of the tunable parame- 
ter used in the mtune file. 

2. value: This field contains the new value for the tunable parame- 
ter. 

The file stune normally resides in /etc/conf/cf.d. However, a user or 
an add-on package should never directly edit the mtune file. Instead 
the idtune command should be used. 

In order for the new values to become effective the Altos UNIX Sys- 
tem V kernel must be rebuilt and the system must then be rebooted. 

See Also 



mtune(F), idbuild(ADM), idtune(ADM) 
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syms 

common object file symbol table format 
Syntax 



#include <syms.h> 

Description 



Common object files contain information to support symbolic soft- 
ware testing [see sdbiC?)], Line number entries, linenum(F), and 
extensive symbolic information permit testing at the C source level. 
Every object file’s symbol table is organized as shown below. 

File name 1. 

Function 1. 

Local symbols for function 1 . 

Function 2. 

Local symbols for function 2. 

Static extems for file 1. 

File name 2. 

Function 1. 

Local symbols for function 1. 

Function 2. 

Local symbols for function 2. 

Static extems for file 2. 



Defined global symbols. 

Undefined global symbols. 

The entry for a symbol is a fixed-length structure. The members of the 
structure hold the name (null paddedX its value, and other information. 
The C structure is given below. 

#define SYMNMLEN 8 
#define FILNMLEN 14 
#define DIMNUM 4 

struct syment 
{ 

union 
{ 

char 
struct 



/* all ways to get symbol name */ 
_n_name[SYMNMLiEN] ; /* symbol name */ 
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{ 



long 


_n_zeroes; 


/* 


= OL when in string table */ 


long 


_n offset; 


/* 


location of name in table */ 


} n n; 








char 
} _n; 
long 


*_n_nptr [2] ; 


/* 


allows overlaying */ 


n_value; 


/* 


value of symbol */ 


short 


n senum; 


/* 


section number */ 


unsigned short 


n_type; 


/* 


type and derived type */ 


char 


n_sclass; 


/* 


storage class */ 


char 

}; 


n numaux; 


/* 


mrtber of aux entries */ 


#define n_naitie 


n. n name 






#define n_zeroes 


_n. n n. n zeroes 




#define n offset 


n. n n. n offset 




#define n_nptr 


_n._n_nptr [1] 







Meaningful values and explanations for them are given in both syms.h 
and Common Object File Format. Anyone who needs to interpret the 
entries should seek more information in these sources. Some symbols 
require more information than a single entry; they are followed by 
auxiliary entries that are the same size as a symbol entry. The format 
follows. 



union auxent 

{ 

struct 

{ 

long x_tagndx; 

union 

{ 

struct 



{ 

unsigned short 
unsigned short 

} x_lnsz; 

long x_fsize; 

} x_inisc; 
union 



x_lnno; 
X size; 



struct 



} 

struct 

{ 



} 

} 

unsigned short 
} x_sym; 

struct 

{ 



long x_lnnoptr; 
long x_endndx; 

X fen; 



unsigned short x_dimen [DIMNUM] ; 

x_ary; 

x_fcnary; 

X tvndx; 
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char x_fname [FILNMLEN] ; 

} x_file; 

struct 
{ 

long x_scnlen; 
unsigned short x_nreloc; 
unsigned short x_nlinno; 

} x_scn; 

struct 
{ 

long 

unsigned short 
unsigned short 
} x_tv; 

}; 

Indexes of symbol table entries begin at zero . 

See Also 



x_tvfill; 
x_tvlen; 
x_tvran[2] ; 



sdb(CP), a.out(F), linenum(F). 

Notes 



On machines on which ints are equivalent to longs, all longs have 
their type changed to int. Thus the information about which symbols 
are declared as longs and which, as ints, does not show up in the sym- 
bol table. 
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sysfiles 

format of UUCP Sysfiles file 

Description 



The /usr/lib/uucp/Sysfiles file lets you assign different files to be 
used by uucp(C) and cu(C) as Systems, Devices, and Dialers files. 

You can use different Systems files so that requests for login services 
can be made to different addresses than UUCP services. 

With different Dialers files you can use different handshaking for cu 
and uucp. Multiple Systems, Dialers, and Devices files are useful if 
any one file becomes too large. 

An active Sysfiles file is not included in the distribution. Instead a 
Sysfiles.eg file is included, which contains comments and commented 
examples of how such a file can be used. This is done because UUCP 
runs faster without reading this file. 

The format of the Sysfiles file is 

service^w systems-x:x dialers=y:y devices=z:z 

where w is replaced by uucico(ADM), cu, or both separated by a 
colon; X is one or more files to be used as the Systems file, with each 
file name separated by a colon and read in the order presented; y is 
one or more files to be used as the Dialers file; and z is one or more 
files to be used as the Devices file. Each file is assumed to be relative 
to the /usr/lib/uucp directory, unless a full path is given. A 
backslash-carriage return (\<CR>) can be used to continue an entry on 
to the next line. 

An example of using a local Systems file in addition to the usual Sys- 
tems file follows: 

service=uucico : cu systems=Systems : Local_Systems 

If this is in lusri lib! uucp! Sysfiles, then both uucico and cu will first 
look in lusrIlibluucpISystems. If the system they’re trying to call 
doesn’t have an entry in that file, or if the entries in the file fail, then 
they’ll look in lusri lib! uucp! Local Systems. 

When different Systems files are defined for uucico and cu services, 
your machine will store two different lists of Systems. You can print 
the uucico list using the uuname command or the cu list using the 
uuname -c command. 
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The following example uses different Systems and Dialers files to 
separate the uucico and cw-specific info, with information that they 
use in common still in the “usual” Systems and Dialers files. 

service=uucico systems=Systems . cico : Systems \ 
dialers=Dialers . cico : Dialers 
service=cu systems=Systems . cu : Systems \ 

dialers=Dialers . cu : Dialers 

This next example uses the same systems files for uucico and cu, but 
has split the Systems file into local, company-wide, and global files. 

service=uucico systems=Systems . local : Systems . conpany : Systems 
service=cu systems=Systems . local : Systems . coitpany : Systems 

See Also 



uucico(ADM), uucp(C), systems(F) 
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systemid 

the Micnet system identification file 

Description 



The systemid file contains the machine and site names for a system in 
a Micnet network. A machine name identifies a system and distin- 
guishes it from other systems in the same network. A site name iden- 
tifies the network to which a system belongs and distinguishes the net- 
work from other networks in the same chain. 

The systemid file may contain a site name and up to four different 
machine names. The file has the form: 

[site-name] 

[machine-name 1] 

[machine-name2] 

[machine-nameS] 

[machine-name4] 

The file must contain at least one machine name. The other machine 
names are optional, serving as alternate names for the same machine. 
The file must contain a site name if more than one machine name is 
given or if the network is connected to another through a uucp link. 
The site name, when given, must be on the first line. 

Each name can have up to eight letters and numbers but must always 
begin with a letter. There is never more than one name to a line. A 
line beginning with a pound sign (#) is considered a comment line and 
is ignored. 

The Micnet network requires one systemid file on each system in a 
network with each file containing a unique set of machine names. If 
the network is connected to another network through a uucp link, each 
file in the network must contain the same site name. 

The systemid file is used primarily during resolution of aliases. When 
aliases contain site and/or machine names, the name is compared with 
the names in the file and removed if there is a match. If there is no 
match, the alias (and associated message, file, or command) is passe 1 
on to the specified site or machine for further processing. 
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/etc/systemid 

See Also 



aliases(M), netutil(ADM), top(F) 

Value Added 



systemid is an extension of AT&T System V provided in Altos UNIX 
System V. 
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systems 

format of UUCP Systems file 

Description 



The Systems file (/usr/lib/uucp/Systems) contains the information 
needed by the uucico daemon to establish a communication link to a 
remote computer. Each entry in the file represents a computer that 
your computer can call. You can configure the Systems file to prevent 
unauthorized computers from logging in on your computer. More than 
one entry may be present for a particular computer. These additional 
entries represent alternative communication paths which the computer 
tries in sequential order. 

Each entry in the Systems file has the following format: 

sitename schedule device speed phone login-script 



sitename 


field contains the node name of the remote com- 
puter. 


schedule 


field is a string that indicates the day-of-week and 
time-of-day when the remote computer can be 
called. 


device 


is the device type that should be used to establish 
the communication link to the remote computer. 


speed 


indicates the transfer speed of the device used in 
establishing the communication link. 


phone 


provides the phone number of the remote com- 
puter for automatic dialers. If you wish to create a 
portable Systems file that can be used at a number 
of sites where the dialing prefixes differ, see the 
dialcodes(¥) man page. 


login-script 


contains login information (also known as a “chat 

script”)- 



See Also 



uucico(ADM), uucp(C), devices(F), dialers(F) 
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tables 

MMDF name tables for aliases, domains, and hosts 

Description 



All of the MMDF name tables are encoded into a database which is 
built on top of the dbm{S) package. A number of tables are associated 
with MMDF, the exact set being specified by the tailor file, 
lusrimmdfimmdftailor. Name tables all have the same format. Func- 
tionally, they permit a simple key/value pairing. The syntax for tables 
is specified here: 



entries ::= 


entries entry 


entry ::= 


comment / real-entry 


comment ::= 


value eol 


real-entry ::= 


name separator value eol 


name ::= 


{string of chars not containing a <separator>} 


separator ::= 


(see the chars in _hkeyend[], usually and 

space} 


value ::= 


(string of chars not containing an <eol>} 


eol ::= 


(see the chars in _hvalend[]] 


where: 




name is 


a key 


value is 


any relevant text. 



Hosts and Domains 

Two basic types of table are host and domain tables. This section 
gives a brief discussion of these concepts in terms of the MMDF sys- 
tem. The domain namespace is treated as a logical global hierarchy, 
according to the model of RFC 819, with subdomains separated by ’.’s 
(e.g ISI.USC.ARPA is a three level hierarchy with ARPA at the top 
level). A host is a computer associated with a channel which may be 
directly connected or reached through a relay associated with the 
channel. The distinction between hosts as physical entities, and 
domains as logical entities should be noted. All hosts known to an 
MMDF system must have unique names. For this reason, the 
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convention of labelling hosts by an associated domain name is 
adopted in many cases. This is a useful method to guarantee unique 
names, but is not required. The domain and host table structures are 
devised with three basic aims in mind: 

1. To map a string into a fully expanded domain name. 

2. To map this domain into a source route starting with a host. 

3. To obtain the transport address associated with the host. 



Domain Tables 

Domains are split in a two-level manner, with the top part of the tree 
specified in the tailor file and the lower parts of the tree in tables. The 
two level structure is intended as a balance between generality and 
efficiency. The order of searching is also specified in the tailor file. 
The structure of a domain table is to have name as the part of the 
domain not in the tailor file. Thus for ISI.USC.ARPA there might be a 
domain ARPA with name=isi.usc or domain USC.ARPA with 
name=isi. The structure of value is: 

value ::= *(domain dm__separator) host 

The possible values of dm_separator are given in tai(S), although typi- 
cally or ’ ’ would be used. This value is essentially a source route 
to be traversed from right to left. Consider an example table for the 
domain ARPA: 

# Sanple ARPA domain table 
isi . use : a . isi . use . arpa 
b . isi . use :b . isi . use . arpa 
f oobar . isi . use :b . isi . use . arpa 

graphies . isi . use : graphies . isi . use . arpa z . mit . arpa 

Thus, if the “isi.usc.arpa” is analyzed, domain table ARPA will be 
selected, and host “a.isi.usc.arpa” associated with domain 
“isi.usc.arpa.” If only “isi.usc” were given, the domain tables would 
be searched in order, and if the ARPA table were the first one to give a 
match, then the same result would be reached. If “foobar.isi.usc” is 
given, it would be mapped to host “b.isi.usc.arpa” and (official) 
domain “b.isi.usc.arpa.” If “graphics.isi.usc.arpa” is given, a source 
route to domain “graphics.isi.usc.arpa” through HOST “z.mit.arpa” 
will be identified. If “xy.isi.usc.arpa” (or “xy.isi.usc”) is given, then 
it will not be found. However, a subdomain will be stripped from the 
left and the search repeated. Thus domain “xy.isi.usc.^a” will be 
identified as reached by a source route through host “a.isi.usc.arpa.” 

As specified earlier, the order of searching is also specified in the 
tailor file. For example, a host in domain UCL-CS.AC.UK, might 
have a search order UCL-CS.AC.UK, AC.UK, UK, SWEDEN, ARPA, 
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Thus, if there were a domain isi.usc.ac.uk, it would be the pre- 
ferred mapping for isi.usc over isi.usc.arpa. The last domain searched 
is null. This could be used to contain random fully qualified domains 
or to identify gateways to other domains. An example file is: 

# Sanple Top level domain table 

# Odd host 

basservax . australia ibasservax . australia Scunthorpe .ac.uk 

# UUCP Gateway 
UUCP : seismo . airpa 

# Mailnet Gateway (-> multics ~> educom ->mailnet) 
mailnet : educom . mailnet mit-multics . arpa 

To specify the top domain in the tailor file, the name and dmn parame- 
ters of the domain should be set to 



Host Tables 

For every host associated with the channel, there will be one or more 
entries. In each case, the key is the name identified from the domain 
tables. A host may have multiple entries if it has more than one trans- 
port address which the channel might utilise. 

When a channel just sends all its mail to a relaying site, the address 
portion (value) of the entry is not needed, directly, during the 
transmission process. Hence, it need not be accurate. However, it 
still is used to logically collect together host names, that is, all table 
entries with the same value are regarded as being aliases for the same 
host. 



P.O. Box Channels 

POBox channels, for passive, telephone-based exchange, operate in 
two modes. In one case, a single login is authorized to pickup all mail 
for the channel. In this case, the host- table addresses are only used for 
the "collecting” function. For the second mode, different logins share 
the channel and are to receive only some of the mail queued for the 
channel. In this case, the login is treated as an "address", and the table 
entries should have the value fields contain the name of the login 
authorized to pickup mail for that "host". 
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Access control tables 

Channels also have access control tables associated with them, to 
determine whether a message is allowed to use a given route. Each 
channel has four (optional) tables that determine the access controls 
used: insrc, outsrc, indest, and outdest. 



Reformatting tables 

There may also be a “known hosts” table associated with each chan- 
nel. This is exactly the same format as a host table. If a message is 
being reformatted, and if an address does not have its host in this list, 
then it will be modified to appear as a percent route (RFC733 or JNT 
Mail route) address, with the local domain as the root. 



Local Aliases 

The password file specifies the name of all local recipients; their mail- 
ing names are their login names. Since this is a rather restricted name 
space, and since it is useful to have some other kinds of locally-known 
names, there is a second file used to specify ’’aliases". The location of 
the aliases file is specified in the tailor file. 

An alias entry may be used for one of five functions: 

1. True aliasing, where the key value maps to a local user’s login 
name, e.g. “dave:dcrocker;’ ’ 

2. Forwarding, where the key value maps to a foreign address, 
such as “dcrocker:dcrocker@udel;’ ’ and 

3. Address lists, where the key value maps to a set of addresses, 
such as “mother:cotton,dcrocker,farber. ” 

4. Redirection of a message to a file. For example, 
“foobar:dpk/foobar” would cause user and group ids to be set 
to dpk and the text of the message to be appended to the file 
“foobar” in dpk’s default login directory. Similarly, 
“foobar:dpk//tmp/foobar” would do the same for file 
/tmp/foobar. 

5. Redirection of a message to a pipe. For example, “news- 
inject:newsl/usr/lib/news/uurec” would cause a message to be 
passed into an Altos UNIX System V pipe (see pipe(S)) with 
userid and groupid set to news. 

As a convenience, the value-part of an entry may specify a file name, 
so that the actual value is taken from the file. There are two possible 
notations for this: 
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1. By having left-angle bracket (’<’) precede the value specifica- 
tion. For example: “mother: < /etc/mmdf/mother_list@udel- 
relay.arpa.” 

2. By using a data type with value “include.” For example: 
“mother: :include: /etc/mmdf/mother@udel-relay.arpa” 

In both cases, the @HOST (not a domain) is optional. If specified, it 
should be the local host. 

Recursive specification is permitted. For example, “crocker” may 
map to “dcrocker” and “dcrocker” may map to “dcrocker at udel,” 
so that both “crocker” and “dcrocker” are locally-known names, but 
mail sent to either of them will be forwarded to “dcrocker@udel.” 

In practice, it is useful to organize alias files into the following order- 
ing: 

List aliases 

which contain a value referring to a later address list. This con- 
stitutes a one-to-one mapping of a key to a value, where the 
value points into the “Lists” group. 

Lists 

which contain values referring to multiple addresses; This con- 
stitutes a one-to-many mapping, where some of the addresses 
may refer to other entries (address lists) in the Lists group, as 
well as other entries (individual addresses) later in the table. 

Mailbox aliases 

which contain values referring to single addresses. These con- 
stitute one-to-one mappings, where the value refers to an entry 
in the password file or to an entry in the “Forwarding aliases” 
group. 

Forwarding aliases 

which contain values referring to single addresses on other ma- 
chines. These, also, are one-to-one mappings, where the value 
always refers to an off-machine address. 

By organizing the file in this manner, only the “Lists” portion 
requires a topological sort. Since the other three sections will never 
point to entries within their section, they may be sorted more con- 
veniently, such as alphabetically. Such a structure also tends to make 
changes easy. In particular, the handling of forwarding is easy, since 
all references to a user will get intercepted, at the end of the table. 



Mail-ID tables 

The Mail-ID tables are used only if the Mail-IDs feature is enabled. 
This can be done in the tailoring file, by defining MMAILID to be 1. 
Mail-IDs are used to disassociate mail addresses from login names. 
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There are two tables that are used to map Mail-IDs to users login 
names and login ids to Mail-IDs. The “users” file is used to map 
users (login ids) to Mail-IDs, and the “mailids” file is used to map 
Mail-IDs to users. The names of these files can be overridden, but it is 
not recommended. Each file has lines with two entries per line (user 
and Mail-ID, or Mail-ID and user). 

A user can have more than one entry in the Mail-IDs file, but should 
have only one entry in the users file. This does not prevent them from 
sending mail with any of their Mail-IDs. The users file is just a source 
of default Mail-IDs. 

Value Added 



tables is an extension of AT&T System V provided in Altos UNIX 
System V. 
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tar 

archive format 

Description 



The command tar{C) dumps files to and extracts files from backup 
media or the hard disk. 

Each file is archived in contiguous blocks, the first block being occu- 
pied by a header, whose format is given below, and the subsequent 
blocks of the files occupying the following blocks. All headers and 
file data start on 512 byte block boundaries and any spare unused 
space is padded with garbage. The format of a header block is as fol- 
lows: 



#define TBLOCK 512 
#define NBLOCK 20 
#define NAMSIZ 100 
union hblock { 

char dummy [TBLOCK] ; 
struct header { 

char name [NAMSIZ] ; 

char mode [ 8 ] ; 

char uid[8]; 

char gid[8]; 

char size [12]; 

char mtime[12]; 

char chksum[8]; 

char linkflag; 

char linkname [NAMSIZ] ; 

char extno[4]; 

char extotal [4]; 

char efsize[12]; 

} dbuf; 

} dblock; 

The name entry is the path name of the file when archived. If the path- 
name starts with a zero word, the entry is empty. It is at most 100 
bytes long and ends in a null byte. Mode, uid, gid, size, and time modi- 
fied are the same as described under i-nodes (refer to filesystem (F)). 
The checksum entry has a value such that the sum of the words of the 
directory entry is zero. 

If the entry corresponds to a link, then linkname contains the path- 
name of the file to which this entry is linked and linkflag is set to 0 if 
there are no links, or 1 if there are links. No data is put in the archive 
file. 
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See Also 
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filesystem(F), tar(C) 

Standards Conformance 



tar is conformant with: 

AT&T SVID Issue 2, Select Code 307-127. 
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term 

terminal driving tables for nroff 
Description 



nroff uses driving tables to customize its output for various types of 
ou^ut devices, such as printing terminals, special word-processing 
printers (such as Diablo, Qume, or NEC Spinwriter mechanisms), or 
special output filter programs. These driving tables are written as C 
programs, compiled, and installed in /usr/lib/term/tabnam^, where 
name is the name for that terminal type as shown in term. 

The structure of the tables is as follows. Sizes are in 240ths of an 
inch. 

tdefine INCH 240 
#incl-ude /usr/lib/term/terms.h 

struct termtable tip ; { \* Ip is the name of the term, *\ 
int bset; \* modify with new name, such as tnew *\ 
int breset; 
int Hor; 
int Vert; 
int Newline; 
int Char; 
int Em; 
int Half line; 
int Adj; 
char *twinit; 
char *twrest; 
char *twnl; 
char *hlr; 
char *hlf; 
char *flr; 
char "^bdon; 
char *bdoff; 
char *iton; 
char *itoff; 
char *ploton; 
char *plotoff; 
char '*'up; 
char *down; 
char *right; 
char *left; 

char ^codetab [256-32] ; 
char *zzz; 

} ; 

The meanings of the various fields are as follows: 
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bset bits to set in termio.c oflag see tty(M) and termio(M)). 

after output. 

breset bits to reset in termio.c oflag before output. 

Hor horizontal resolution in fractions of an inch. 

Vert vertical resolution in fractions of an inch. 

Newline space moved by a newline (linefeed) character in frac- 
tions of an inch. 

Char quantum of character sizes, in fractions of an inch, (i.e., 
characters are multiples of Char units wide. See codetab 
below.) 

Em size of an em in fractions of an inch. 

Halfline space moved by a half-linefeed (or half-reverse-linefeed) 
character in fractions of an inch. 

Adj quantum of white space for margin adjustment in the 

absence of the -e option, in fractions of an inch, (i.e., 
white spaces are a multiple of Adj units wide) 

Note: if this is less than the size of the space character (in 
units of Char; see below for how the sizes of characters 
are defined), nroff will output fractional spaces using plot 
mode. Also, if the -e switch to nroff is used, Adj is set 
equal to Hor by nroff. 

twinit set of characters used to initialize the terminal in a mode 
suitable for nroff. 

twrest set of characters used to restore the terminal to normal 
mode. 

twnl set of characters used to move down one line. 

hlr set of characters used to move up one-half line. 

hlf set of characters used to move down one-half line. 

fir set of characters used to move up one line. 
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bdon set of characters used to turn on hardware boldface mode, 
if any. Nroff assumes that boldface mode is reset auto- 
matically by the twnl string, because many letter-quality 
printers reset the boldface mode when they receive a car- 
riage return; the twnl string should include whatever char- 
acters are necessary to reset the boldface mode. 

bdojf set of characters used to turn off hardware boldface mode, 
if any. 

iton set of characters used to turn on hardware italics mode, if 

any. 

itoff set of characters used to turn off hardware italics mode, if 

any. 

ploton set of characters used to turn on hardware plot mode (for 
Diablo-type mechanisms), if any. 

plotojf set of characters used to turn off hardware plot mode (for 
Diablo-type mechanisms), if any. 

up set of characters used to move up one resolution unit 

(Vert) in plot mode, if any. 

down set of characters used to move down one resolution unit 
(Vert) in plot mode, if any. 

right set of characters used to move right one resolution unit 
(Hor) in plot mode, if any. 

left set of characters used to move left one resolution unit 

(Hor) in plot mode, if any. 

codetab Array of sequences to print individual characters. Order 
is nroffs internal ordering. See the file 
/usr/lib/term/tabuser.c for the exact order. 

zzz a zero terminator at the end. 

The codetab sequences each begin with a flag byte. The top bit indi- 
cates whether the sequence should be underlined in the .ul font. The 
rest of the byte is the width of the sequence in units of Char. 

The remainder of each codetab sequence is a sequence of characters 
to be output. Characters with the top bit off are output as given; char- 
acters with the top bit on indicate escape into plot mode. When such 
an escape character is encountered, nroff shifts into plot mode, emit- 
ting ploton, and skips to the next character if the escape character was 
^ 200 ^ 
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When in plot mode, characters with the top bit off are output as given. 
A character with the top bit on indicates a motion. The next bit indi- 
cates coordinate, with 1 being vertical and 0 being horizontal. 

The next bit indicates direction, with 1 meaning up or left. The 
remaining five bits give the amount of the motion. An amount of zero 
causes exit from plot mode. 

When plot mode is exited, either at the end of the string or via the 
amount- zero exit, plotoffis emitted followed by a blank. 

All quantities which are in units of fractions of an inch should be 
expressed as l^CYi'^numldenom, where num and denom are respec- 
tively the numerator and denominator of the fraction; that is, 1/48 of 
an inch would be written as “INCH/48”. 

If any sequence of characters does not pertain to the output device, 
that sequence should be given as a null string. 

The Development System must be installed on the computer to create 
a new driving table. The source code for a generic output device is in 
the file /usr/lib/term/tabuser.c Copy this file and make the necessary 
modifications, including the name of the termtable struct. Refer to the 
hardware manual for the codes needed for the output device (terminal, 
printer, etc.). Name the file according to the convention explained in 
the term file accompanying your nr off package. The makefile, 
/usr/lib/term/ make file, should be updated to include the source file to 
the new driving table. To perform the modification, enter the com- 
mand: 



cc -M3e -O -c tabuser.c maketerm.o -o maketerm 
When the files are prepared, enter the command : 
make 

(See make(CP)). The source to the new driving table is linked with 
the object file mkterm.o, and the new driving table is created and 
installed in the proper directory. 

Files 



/usrAib/term/tabmjm^ driving tables 
/usr/lib/term/tabuser.c generic source for driving tables 
/usrAib/term/makefile makefile for creating driving tables 
/usrAib/term/mkterm.olinkable object file for creating driving tables 
/usrAib/term/terms.h used to create nrofif driving tables 

See Also 



nrofif and term in the documentation accompanying your text pro- 
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cessing package. 

Notes 



Altos UNIX System V does not include nroff, its special term file, or 
any of the other facilities commonly associated with it. You must pur- 
chase this text processing package separately. The Development Sys- 
tem and text processing software must be installed on the computer to 
create new driving tables. 

Not all UNIX facilities support all of these options. 
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termcap 

terminal capability data base 

Description 



The file /etc/termcap is a data base describing t^minals. Thi^ data 
base is used by commands such as v/(C), Lyrix^, Multiplan™ and 
sub-routine packages such as curses (S). Terminals are described in 
termcap by giving a set of capabilities and by describing how opera- 
tions are performed. Padding requirements and initialization 
sequences are included in termcap. 

Entries in termcap consist of a number of fields separated by colons 
The first entry for each terminal gives the names that are known 
for the terminal, separated by vertical bars ( I ). For compatibility 
with older systems the first name is always 2 characters long. The 
second name given is the most common abbreviation for the terminal 
and the name used by vi(C) and ex(C). The last name given should be 
a long name fully identifying the terminal. Only the last name can 
contain blanks for readability. 

Capabilities (including XENIX Extensions) 



The following is a list of the capabilities that can be defined for a 
given terminal. In this list, (P) indicates padding can be specified, and 
(P*) indicates that padding can be based on the number of lines 
affected. The capability type and padding fields are described in 
detail in the following section “Types of Capabilities.” 

The codes beginning with uppercase letters (except for CC) indicate 
XENIX extensions. They are included in addition to the standard 
entries and are used by one or more application programs. As with the 
standard entries, not all modes are supported by all applications or ter- 
minals. Some of these entries refer to specific terminal output capa- 
bilities (such as GS for “graphics start”). Others describe character 
sequences sent by keys that appear on a keyboard (such as PU for 
PageUp key). There are also entries that are used to attribute special 
meanings to other keys (or combinations of keys) for use in a particu- 
lar software program. Some of the XENIX extension capabilities have 
a similar function to standard capabilities. They are used to redefine 
specific keys (such as using function keys as arrow keys). The exten- 
sion capabilities are included in the /etc/termcap file, as they are 
required for some utilities. The more commonly used extension capa- 
bilities are described in more detail in the section “XENIX Exten- 
sions.” 
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Name 


Type Pad? Description 


ae 


str 


(p) 


End alternate character set 


al 


str 


(P*) 


Add new blank line 


am 


bool 




Terminal has automatic margins 


as 


str 


(p) 


Start alternate character set 


be 


str 




Backspace if not "H 


bs 


bool 




Terminal can backspace with "H 


bt 


str 


(p) 


Back tab 


bw 


bool 




Backspace wraps from column 0 
to last column 


CC 


str 




Command character in prototype 
if terminal settable 


cd 


str 


(p*) 


Clear to end of display 


ce 


str 


(p) 


Clear to end of line 


CF 


str 


Cursor off 


ch 


str 


(p) 


Like cm but horizontal motion only, 
line stays same 


CL 


str 




Sent by CHAR LEFT key 


cl 


str 


(p*) 


Clear screen 


cm 


str 


(p) 


Cursor motion 


CO 


num 


Number of columns in a line 


CO 


str 




Cursor on 


cr 


str 


(p*) 


Carriage return, (default "M) 


cs 


str 


(p) 


Change scrolling region (vtlOO), like cm 


cv 


str 


(p) 


Like ch but vertical only. 


CW 


str 


Sent by CHANGE WINDOW key 


da 


bool 




Display may be retained above 


DA 


bool 




Delete attribute string 


db 


bool 




Display may be retained below 


dB 


num 




Number of millisec of bs delay needed 


dC 


num 




Number of millisec of cr delay needed 


dc 


str 


(p*) 


Delete character 


dF 


num 


Number of millisec of ff delay needed 


dl 


str 


(p*) 


Delete line 


dm 


str 


Delete mode (enter) 


dN 


num 




Number of millisec of nl delay needed 


do 


str 




Down one line 


dT 


num 




Number of millisec of tab delay needed 


ed 


str 




End delete mode 


ei 


str 




End insert mode; give ' :ei=: ' 
if ic 


EN 


str 




Sent by END key 


eo 


bool 




Can erase overstrikes with a blank 


ff 


str 


(p*) 


Hardcopy terminal page eject (default "L) 


G1 


str 




Upper-right (1st quadrant) comer character 


G2 


str 




Upper-left (2nd quadrant) comer character 
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Name T^pe Pad? Description 



G3 


str 




Lower-left (3rd quadrant) comer character 


G4 


str 




Lower-right (4th quadrant) comer character 


GC 


str 




Center graphics character (similar to “+”) 


GD 


str 




Down-tick character 


GE 


str 




Graphics mode end 


GG 


num 




Number of chars taken by GS and GE 


GH 


str 




Horizontal bar character 


GL 


str 




Left-tick character 


GR 


str 




Right-tick character 


GS 


str 




Graphics mode start 


GU 


str 




Up-tick character 


GV 


str 




Vertical bar character 


he 


bool 




Hardcopy terminal 


hd 


str 




Half-line down (forward 1/2 linefeed) 


HM 


str 




Sent by HOME key (if not kh) 


ho 


str 




Home cursor (if no cm) 


hu 


str 




Half-line up (reverse 1/2 linefeed) 


hz 


str 




Hazeltine; can’t print ~’s 


ic 


str 


(p) 


Insert character 


if 


str 




Name of file containing is 


im 


str 




Insert mode (enter); give ‘:im=’ if ic 


in 


bool 




Insert mode distinguishes nulls on display 


ip 


str 


(p*) 


Insert pad after character inserted 


is 


str 




Terminal initialization string 



k0-k9 str Sent by ‘other’ function keys 0-9 

kb str Sent by backspace key 

kd str Sent by terminal down arrow key 

ke str Out of ‘keypad transmit’ mode 

kh str Sent by home key 

kl str Sent by terminal left arrow key 

kn num Number of ‘other’ keys 

ko str Termcap entries for other non-function keys 

kr str Sent by terminal right arrow key 

ks str Put terminal in ‘keypad transmit’ mode 

ku str Sent by terminal up arrow key 

10-19 str Labels on ‘other’ function keys 

LD str Sent by line delete key 

LF str Sent by line feed key 

li num Number of lines on screen or page 

11 str Last line, first column (if no cm) 

ma str Arrow key map, used by vi version 2 only 

mi bool Safe to move while in insert mode 

ml str Memory lock on above cursor 

MP str Multiplan initialization string 

MR str Multiplan reset string 

ms bool Will scroll in stand-out mode 

mu str Memory unlock (turn off memory lock) 
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Name 


Type Pad? Description 


nc 


bool 




No correctly working carriage return 
(DM2500,H2000) 


nd 


str 




Non-destructive space (cursor right) 


nl 


str 


(p*) 


Newline character (default \n) 


ns 


bool 




Terminal is a CRT but doesn’t scroll 


NU 


str 




Sent by NEXT UNLOCKED CELL key 


os 


bool 




Terminal overstrikes 


pc 


str 




Pad character (rather than null) 


PD 


str 




Sent by PAGE DOWN key 


“PN ' 


str 




StartlbcMpriming “ ^ ^ 


PS 


str 




End local printing / 


Pt 


bool 




Has hardware tabs 
(may need to be set with is) 


PU 


str 




Sent by PAGE UP key 


RC 


str 




Sent by RECALC key 


RF 


str 




Sent by TOGGLE REFERENCE key 


RT 


str 




Sent by RETURN key 


se 


str 




End stand out mode 


sf 


str 


(p) 


Scroll forwards 


sg 


num 


Number of blank chars left by so or se 


so 


str 




Begin stand out mode 


sr 


str 


(p) 


Scroll reverse (backwards) 


ta 


str 


(p) 


Tab (other than "I or with padding) 


tc 


str 




Entry of similar terminal - must be last 


te 


str 




String to end programs that use cm 


ti 


str 




String to begin programs that use cm 


uc 


str 




Underscore one char and move past it 


ue 


str 




End underscore mode 


ug 


num 




Number of blank chars left by us or ue 


ul 


bool 




Terminal underlines even though 
it doesn’t overstrike 


up 


str 




Upline (cursor up) 


UP 


str 




Sent by up-arrow key (alternate to ku) 


us 


str 




Start underscore mode 


vb 


str 




Visible bell (may not move cursor) 


ve 


str 




Sequence to end open/visual mode 


vs 


str 




Sequence to start open/visual mode 


WL 


str 




Sent by WORD LEFT key 


WR 


str 




Sent by WORD RIGHT key 


xb 


bool 




Beehive (fl=escape, f2=ctrl C) 


xn 


bool 




A newline is ignored after a wrap 
(Concept) 


xr 


bool 




Return acts like ce V \n 
(Delta Data) 


xs 


bool 




Standard out not erased by writing over it 
(HP 264?) 


xt 


bool 




Tabs are destructive, magic so char 
(Teleray 1061) 
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A Sample Entry 

The following entry describes the Concept- 100, and is among the 
more complex entries in the termcap file. (This particular Concept 
entry is outdated, and is used as an example only.) 

cl I clOO I COnceptlOO:is=\EU\Ef\E7\E5\E8\El\ENH\EK\E\200\Eo&\200:\ 

: al=3*\E"R : am:bs : cd=16*\E^C : ce=16\E^S : cl=2* : \ 

:atF=\Ea%+ %+ :co#80:dc=16\E"A:dl=3*\E"B:\ 

: ei=\E\200 : eo : inr=\E"P : in : ip=16* : li#24 :mi : nd=\E= : \ 

: se=\Ed\Ee ; so=\ED\EE : ta=8\t : ul : up=\E; : vb=\Ek\EK : xn : 



Entries may continue over to multiple lines by giving a backslash (\) 
as the last character of a line. Empty fields can be included for reada- 
bility between the last field on a line and the first field on the next. 
Capabilities in termcap are of three types: Boolean capabilities, 
which indicate that the terminal has some particular feature, numeric 
capabilities giving the size of the terminal or the size of particular 
delays, and string capabilities, which give a sequence that can be used 
to perform particular terminal operations. 

Types of Capabilities 

All capabilities have two letter codes. For instance, the fact that the 
Concept has ‘automatic margins’ (i.e., an automatic return and 
linefeed when the end of a line is reached) is indicated by the capabil- 
ity am. The description of the Concept includes am. Numeric capa- 
bilities are followed by the character ‘#’ and then the value. Thus co, 
which indicates the number of columns the terminal has, gives the 
value ‘80’ for the Concept. 

Finally, string valued capabilities, such as ce (clear to end of line 
sequence) are given by the two character code, an ‘=’, and then a 
string ending at the next following A delay in milliseconds may 
appear after the ‘=’ in such a capability, and padding characters are 
supplied by the editor after the rest of the string is sent to provide this 
delay. The delay can be either a integer, e.g., ‘20’, or an integer fol- 
lowed by an i.e. ‘3*’. A ‘*’ indicates that the padding required is 
proportional to the number of lines affected by the operation, and the 
amount given is the per-affected-unit padding required. When a ‘*’ is 
specified, it is sometimes useful to give a delay of the form ‘3.5’ to 
specify a delay per unit to tenths of milliseconds. 

A number of escape sequences are provided in the string valued capa- 
bilities for easy encoding of characters there. A \E maps to an ESCAPE 
character, "x maps to a control-x for any appropriate x, and the 
sequences \n \r \t \b \f give a newline, return, tab, backspace and 
formfeed. Finally, characters may be given as three octal digits after a 
\, and the characters " and \ may be given as V and W. If it is necessary 
to place a colon (:) in a capability, it must be escaped in octal as \072. 
If it is necessary to place a null character in a string capability, it must 
be encoded as \200. The routines that deal with termcap use C strings. 
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and strip the high bits of the output very late so that a \200 comes out 
as a \000 would. 

Preparing Descriptions 

The most effective way to prepare a terminal description is by imitat- 
ing the description of a similar terminal in termcap and to build up a 
description gradually, using partial descriptions with ex to check that 
they are correct. Be aware that a very unusual terminal may expose 
deficiencies in the ability of the termcap file to describe it. To test a 
new terminal description, you can set the environment variable 
TERMCAP to a pathname of a file containing the description you are 
working on and the editor will look there rather than in /etc/termcap. 
TERMCAP can also be set to the termcap entry itself to avoid reading 
the file when starting up the editor. 

Basic capabilities 

The number of columns on each line for the terminal is given by the 
CO numeric capability. If the terminal is a CRT, the number of lines on 
the screen is given by the li capability. If the terminal wraps around to 
the beginning of the next line when it reaches the right margin, it 
should have the am capability. If the terminal can clear its screen, 
this is given by the cl string capability. If the terminal can backspace, 
it should have the bs capability, unless a backspace is accomplished 
by a character other than "H in which case you should give this char- 
acter as the be string capability. If it overstrikes (rather than clearing a 
position when a character is struck over), it should have the os capa- 
bility. 

A very important point here is that the local cursor motions encoded in 
termcap are undefined at the left and top edges of a CRT terminal. The 
editor will never attempt to backspace around the left edge, nor will it 
attempt to go up locally off the top. The editor assumes that feeding 
off the bottom of the screen will cause the screen to scroll up, and the 
am capability tells whether the cursor sticks at the right edge of the 
screen. If the terminal has switch selectable automatic margins, the 
termcap file usually assumes that this is on (i.e., am). 

These capabilities suffice to describe hardcopy and “glass-tty” termi- 
nals. Thus the model 33 teletype is described as 

t3 I 33 I tty33 :co#72 :os 

while the Lear Siegler ADM-3 is described as: 

cl I adm3 | 3 | Isi adm3 :am:bs : cl="Z : li#24 : co#80 

Cursor addressing 
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Cursor addressing in the terminal is described by a cm string capabil- 
ity. This capability uses printf(S) like escapes (such as %x) in it. 
These substitute to encodings of the current line or column position, 
while other characters are passed through unchanged. If the cm string 
is thought of as being a function, its arguments are the line and then 
the column to which motion is desired, and the % encodings have the 



following meanings: 


%d 


replaced by line/column position, 0 origin 


%2 


like %2d - 2 digit field 


%3 


like %3d - 3 digit field 


%. 


like printJ{S) %c 


%+x 


adds X to value, then %. 


%>xy 


if value > x adds y, no output 


%r 


reverses order of line and column, no output 


%i 


increments line/column position (for 1 origin) 


%% 


gives a single % 


%n 


exclusive or row and column with 0140 
(DM2500) 


%B 


BCD (16*(x/10)) + (x%10), no output 


%D 


Reverse coding (x-2*(x%16)), no output 
(Delta Data). 



Consider the HP2645, which, to get to row 3 and column 12, needs to 
be sent\E&al2c03Y padded for 6 milliseconds. Note that the order of 
the rows and columns is inverted here, and that the row and column 
are printed as two digits. Thus its cm capability is 
‘cm=^&%r%2c%2Y’. The Microterm ACT-IV needs the current row 
and column sent preceded by a "'T, with the row and column simply 
encoded in binary, ‘cm="T%.%.’. Terminals that use need to be 
able to backspace the cursor (bs or be), and to move the cursor up one 
line on the screen (up introduced below). This is necessary because it 
is not always safe to transmit \t, \n "D and \r, as the system may 
change or discard them. 

A final example is the LSI ADM-3a, which uses row and column offset 
by a blank character, thus ‘cm=\E=%+ %+ ’. 

Cursor motions 

If the terminal can move the cursor one position to the right, leaving 
the character at the current position unchanged, this sequence should 
be given as nd (non-destructive space). If it can move the cursor up a 
line on the screen in the same column, it should be given as up. If the 
terminal has no cursor addressing capability, but can home the cursor 
(to very upper left comer of screen), this can be given as ho; similarly, 
a fast way of getting to the lower left hand comer can be given as 11; 
this may involve going up with up from the home position, but the 
editor will never do this itself (unless 11 does) because it makes no 
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assumption about the effect of moving up from the home position. 

Area clears 

If the terminal can clear from the current position to the end of the 
line, leaving the cursor where it is, the sequence should be given as ce. 
If the terminal can clear from the current position to the end of the dis- 
play, the sequence should be given as cd. The editor only uses cd 
from the first column of a line. 

Insert/delete line 

If the terminal can open a new blank line before the line where the 
cursor is, the sequence should be given as al. Note that this is done 
only from the first position of a line. The cursor must then appear on 
the newly blank line. If the terminal can delete the line on which the 
cursor rests, the sequence should be given as dl. This is done only 
from the first position on the line to be deleted. If the terminal can 
scroll the screen backwards, the sequence can be given as sb, but al 
can suffice. If the terminal can retain display memory above, the da 
capability should be given, and if display memory can be retained 
below, then db should be given. These let the editor know that delet- 
ing a line on the screen may bring non-blank lines up from below or 
that scrolling back with sb may bring down non-blank lines. 

Insertidelete character 

There are two basic kinds of intelligent terminals with respect to the 
insert/delete character that can be described using termcap. The most 
common insert/delete character operations affect only the characters 
on the current line and shift characters off the end of the line. Other 
terminals, such as the Concept 100 and the Perkin Elmer Owl, make a 
distinction between typed and untyped blanks on the screen, shifting 
upon an insert or delete only to an untyped blank on the screen which 
is either eliminated, or expanded to two untyped blanks. You can find 
out which kind of terminal you have by clearing the screen and enter- 
ing text separated by cursor motions. Enter ‘abc def’, using local 
cursor motions (not spaces) between the ‘abc’ and the ‘def. Then 
position the cursor before the ‘abc’ and put the terminal in insert 
mode. If entering characters causes the rest of the line to shift rigidly 
and characters to fall off the end, your terminal does not distinguish 
between blanks and untyped positions. If the ‘abc’ shifts over to the 
‘def’ which then move together around the end of the current line and 
onto the next as you insert, you have the second type of terminal, and 
should give the capability in, which stands for ‘insert null’. No known 
terminals have an insert mode, not falling into one of these two 
classes. 

The editor can handle both terminals that have an insert mode and ter- 
minals that send a simple sequence to open a blank position on the 
current line. Specify im as the sequence to get into insert mode, or 
give it an empty value if your terminal uses a sequence to insert a 
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blank position. Specify ei as the sequence to leave insert mode 
(specify this with an empty value if you also gave im an empty value). 
Now specify ic as any sequence needed to be sent just before sending 
the character to be inserted. Most terminals with a true insert mode 
will not support ic, terminals that send a sequence to open a screen 
position should give it here. (Insert mode is preferable to the sequence 
to open a position on the screen if your terminal has both.) If post 
insert padding is needed, give this as a number of milliseconds in ip (a 
string option). Any other sequence that may need to be sent after an 
insert of a single character may also be given in ip. 

It is occasionally necessary to move around while in insert mode to 
delete characters on the same line (e.g., if there is a tab after the inser- 
tion position). If your terminal allows motion while in insert mode, 
you can give the capability mi to speed up inserting in this case. Omit- 
ting mi will affect only speed. Some terminals (notably Datamedia’s) 
must not have mi because of the way their insert mode works. 

Finally, you can specify delete mode by giving dm and ed to enter and 
exit delete mode, and dc to delete a single character while in delete 
mode. 

Highlightings underlinings and visible bells 

If your terminal has sequences to enter and exit standout mode, these 
can be given as so and se respectively. If there are several flavors of 
standout mode (such as reverse video, blinking, or underlining - half 
bright is not usually an acceptable ‘standout’ mode unless the terminal 
is in reverse video mode constantly), the preferred mode is reverse 
video by itself. It is acceptable, if the code to change into or out of 
standout mode leaves one, or even two blank spaces on the screen, as 
the TVI 912 and Teleray 1061 do. Although it may confuse some pro- 
grams slightly, it cannot be helped. 

Codes to begin underlining and end underlining can be given as us, 
and ue respectively. If the terminal has a code to underline the current 
character and move the cursor one space to the right, such as the 
Microterm Mime, the sequence can be given as uc. (If the underline 
code does not move the cursor to the right, specify the code followed 
by a nondestructive space.) 

If the terminal has a way of flashing the screen to indicate an error 
quietly (a bell replacement), the sequence can be given as vb; it must 
not move the cursor. If the terminal should be placed in a different 
mode during open and visual modes of eXs the sequence can be given 
as vs and ve, sent at the start and end of these modes respectively. 
These can be used to change from a underline to a block cursor and 
back. 

If the terminal needs to be in a special mode when running a program 
that addresses the cursor, the codes to enter and exit this mode can be 
given as ti and te. This arises, for example, from terminals like the 
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Concept with more than one page of memory. If the terminal has only 
memory relative cursor addressing and not screen relative cursor 
addressing, a one screen-sized window must be fixed into the terminal 
for cursor addressing to work properly. 

If your terminal correctly generates underlined characters (with no 
special codes, needed), even though it does not overstrike, you should 
give the capability ul. If overstrikes are erasable with a blank, this 
should be indicated by specifying eo. 

Keypad 

If the terminal has a keypad that transmits codes when the keys are 
pressed, this information can be given. Note that it is not possible to 
handle terminals where the keypad only works in local (this applies, 
for example, to the unshifted HP 2621 keys). If the keypad can be set 
to transmit or not to transmit, enter these codes as ks and ke. Other- 
wise, the keypad is assumed always to transmit. The codes sent by the 
left arrow, right arrow, up arrow, down arrow, and home keys can be 
given as kl, kr, ku, kd, and kh. If there are function keys such as fO, 
fl, ..., f9, the codes they send can be given as kO, kl, k9. If there 
are other keys that transmit the same code as the terminal expects for 
the corresponding function, such as clear screen, the termcap 2 letter 
codes can be given in the ko capability, for example, ‘:ko=cl,ll,sf,sb:’, 
which says that the terminal has clear, home down, scroll down, and 
scroll up keys that transmit the same thing as the cl, 11, sf, and sb 
entries. 

The ma entry is also used to indicate arrow keys on terminals which 
have single character arrow keys. It is obsolete, but still in use in ver- 
sion 2 of vi, which must be run on some minicomputers due to mem- 
ory limitations. This field is redundant with kl, kr, ku, kd, and kh. It 
consists of groups of two characters. In each group, the first character 
is what an arrow key sends, the second character is the corresponding 
vi command. These commands are h for kl, j for kd, k for ku, 1 for kr, 
and H for kh. For example, the Mime would be :ma="Kj"Zk"XI: 
indicating arrow keys left ("H), down ("K), up ("Z), and right ("X). 
(There is no home key on the Mime.) 

Miscellaneous 

If the terminal requires other than a null (zero) character as a pad, this 
can be given as pc. 

If tabs on the terminal require padding, or if the terminal uses a char- 
acter other than "I to tab, the sequence can be given as ta. 

Terminals that do not allow characters to be displayed (such as 
Hazeltines), should indicate hz. Datamedia terminals that echo 
carriage-retum-linefeed for carriage return, and then ignore a follow- 
ing linefeed, should indicate nc. Early Concept terminals, that ignore 
a linefeed immediately after an am wrap, should indicate xn. If an 
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erase-eol is required to get rid of standout (instead of merely writing 
on top of it), xs should be given. Teleray terminals, where tabs turn all 
characters moved over to blanks, should indicate xt. Other specific 
terminal problems may be corrected by adding more capabilities of 
the form xx. 

If the leading character for commands to the terminal (normally the 
escape character) can be set by the software, specify the command 
character(s) with the capability CC. 

Other capabilities include is, an initialization string for the terminal, 
and if, the name of a file containing long initialization strings. These 
strings are expected to properly clear and then set the tabs on the ter- 
minal, if the terminal has settable tabs. If both are given, is is dis- 
played before if. This is useful where if is /usr/lib/tabset/std , but is 
clears the tabs first. 

Similar Terminals 

If there are two very similar terminals, one can be defined as being 
just like the other with certain exceptions. The string capability, tc, 
can be given with the name of the similar terminal. This capability 
must be last and the combined length of the two entries must not 
exceed 1024. Since termlib routines search the entry from left to right, 
and since the tc capability is replaced by the corresponding entry, the 
capabilities given at the left override the ones in the similar terminal. 
A capability can be canceled with xx@ where xx is the capability. 
For example: 

hn I 2621nl:ks@:ke0:tc=2621: 

This defines a 262 Inl that does not have the ks or ke capabilities, and 
does not turn on the function key labels when in visual mode. This is 
useful for different modes for a terminal, or for different user prefer- 
ences. 

XENIX Extensions 

Capabilities This table lists the (previously listed) XENIX extensions 
to the termcap capabilities. It shows which codes generate information 
input from the keyboard to the program reading the keyboard and 
which codes generate information output from the program to the 
screen. 
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Name 


Input/ Outpu tDescrip tion 


CF 


str 


Cursor off 


CL 


str 


Sent by CHAR LEFT key 


CO 


str 


Cursor on 


CW 


str 


Sent by CHANGE WINDOW key 


DA 


bool 


Delete attribute string 


EN 


str 


Sent by END key 


G1 


str 


Upper-right (1st quadrant) comer character 


G2 


str 


Upper-left (2nd quadrant) comer character 


G3 


str 


Lower-left (3rd quadrant) comer character 


G4 


str 


Lower-right (4th quadrant) comer character 


G5 


str 


Upper right (1st quadrant) comer character (double) 


G6 


str 


Upper left (2nd quadrant) comer character (double) 


G7 


str 


Lower left (3rd quadrant) comer character (double) 


G8 


str 


Lower right (4th quadrant) comer character (double) 


GC 


str 


Center graphics character (similar to +) 


Gc 


str 


Centre graphics character (double) 


GD 


str 


Down-tick character 


Gd 


str 


Down tick character (double) 


GE 


str 


Graphics mode end 


GG 


num 


Number of chars taken by GS and GE 


GH 


str 


Horizontal bar character 


Gh 


str 


Horizontal bar character (double) 


GL 


str 


Left-tick character 


G1 


str 


left-tick character (double) 


GR 


str 


Right-tick character 


Gr 


str 


right-tick character (double) 


GS 


str 


Graphics mode start 


GU 


str 


Up-tick character 


Gu 


str 


Up-tick character (double) 


GV 


str 


Vertical bar character 


Gv 


str 


Vertical bar character (double) 


HM 


str 


Sent by HOME key (if not kh) 


mb 


str 


blinking on 


me 


str 


blinking off 


MP 


str 


Multiplan initialization string 


MR 


str 


Multiplan reset string 


NU 


str 


Sent by NEXT UNLOCKED CELL key 


PD 


str 


Sent by PAGE DOWN key 


PU 


str 


Sent by PAGE UP key 


RC 


str 


Sent by RECALC key 


RF 


str 


Sent by TOGGLE REFERENCE key 


RT 


str 


Sent by RETURN key 


UP 


str 


Sent by up-arrow key (alternate to ku) 


WL 


str 


Sent by WORD LEFT key 


WR 


str 


Sent by WORD RIGHT key 



Cursor motion Some application programs make use of special editing 
codes. CR and CL move the cursor one character right and left 
respectively. WR and WL move the cursor one word right and left 
respectively. CW changes windows, when they are used in the 
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program. 

Some application programs turn off the cursor. This is accomplished 
using CF for cursor off and CO to turn it back on. 

Graphic mode. If the terminal has graphics capabilities, this mode 
can be turned on and off with the GS and GE codes. Some terminals 
generate graphics characters from all keys when in graphics mode 
(such as the Visual 50). The other G codes specify particular graphics 
characters accessed by escape sequences. These characters are avail- 
able on some terminaJs as alternate graphics character sets (not as a 
bit-map graphic mode). The vtlOO has access to this kind of alternate 
graphics character set, but not to a bit-map graphic mode. 

Files 



/etc/termcap File containing terminal descriptions 

See Also 



ex(C), curses(S), termcap(S), tset(C), vi(C), more(C), screen(HW) 

Credit 



This utility was developed at the University of California at Berkeley 
and is used with permission. 

Notes 



ex{C) allows only 256 characters for string capabilities, and the rou- 
tines in termcap(S) do not check for overflow of this buffer. The total 
length of a single entry (excluding only escaped newlines) may not 
exceed 1024. 

The ma, vs, and ve entries are specific to the v/(C) program. 

Not all programs support all entries. There are entries that are not 
supported by any program. 

XENIX termcap extensions are explained in detail in the softwa’*e 
application documentation. 

Refer to the screen manual page, for a description of the charac- 
ter sequences used by the monitor device on your specific system. 
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term info 

format of compiled terminfo file 
Description 



Compiled terminfo descriptions are placed under the directory 
/usr/lib/terminfo. In order to avoid a linear search of a huge UNIX 
system directory, a two-level scheme is used: 

/usr/lib/terminfo/ c/name where name is the name of the terminal, 
and c is the first character of name. Thus, act4 can be found in the file 
/usr/lib/terminfo/ a/act4. Synonyms for the same terminal are imple- 
mented by multiple links to the same compiled file. 

The format has been chosen so that it will be the same on all hard- 
ware. An 8- or more-bit byte is assumed, but no assumptions about 
byte ordering or sign extension are made. 

The compiled file is created with the tic{C) program, and read by the 
routine setupterm in terminfo{S). The file is divided into six parts: 
the header, terminal names, boolean flags, numbers, strings, and string 
table. 

The header section begins the file. This section contains six short 
integers in the format described below. These integers are (1) the 
magic number (octal 0432); (2) the size, in bytes, of the names sec- 
tion; (3) the number of bytes in the boolean section; (4) the number of 
short integers in the numbers section; (5) the number of offsets (short 
integers) in the strings section; (6) the size, in bytes, of the string 
table. 

Short integers are stored in two 8-bit bytes. The first byte contains the 
least significant 8 bits of the value, and the second byte contains the 
most significant 8 bits. (Thus, the value represented is 
256*second+first.) The value -1 is represented by 0377, 0377; other 
negative values are illegal. The -1 generally means that a capability is 
missing from this terminal. Note that this format corresponds to the 
hardware of the VAX and PDP-11. Machines in which this does not 
correspond to the hardware read the integers as two bytes and compute 
the result. 

The terminal names section comes next. It contains the first line of 
the terminfo description, listing the various names for the terminal, 
separated by the ‘I’ character. The section is terminated with an 
ASCII NUL character. 
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The boolean flags have one byte for each flag. This byte is either 0 or 
1, as the flag is present or absent. The capabilities are in the same 
order as the file <term.h>. 

Between the boolean section and the number section, a null byte will 
be inserted, if necessary, to ensure that the number section begins on 
an even byte. All short integers are aligned on a short-word boundary. 

The numbers section is similar to the flags section. Each capability 
takes up two bytes, and is stored as a short integer. If the value 
represented is -1, the capability is taken to be missing. 

The strings section is also similar. Each capability is stored as a short 
integer, in the format above. A value of -1 means the capability is 
missing. Otherwise, the value is taken as an offset from the beginning 
of the string table. Special characters in "X or\c notation are stored in 
their interpreted form, not the printing representation. Padding infor- 
mation $<nn> and parameter information %x are stored intact in unin- 
terpreted form. 

The final section is the string table. It contains all the values of string 
capabilities referenced in the string section. Each string is null- 
terminated. 

Note that it is possible for setupterm to expect a different set of capa- 
bilities than are actually present in the file. Either the database may 
have been updated since setupterm was recompiled (resulting in extra 
unrecognized entries in the file) or the program may have been recom- 
piled more recently than the database was updated (resulting in miss- 
ing entries). The routine setupterm must be prepared for both possibil- 
ities; this is why the numbers and sizes are included. Also, new capa- 
bilities must always be added at the end of the lists of boolean, num- 
ber, and string capabilities. 

As an example, an octal dump of the description for the Microterm 
ACT 4 is included: 



microterm I act 4 | microterm act iv, 

cr="M, cudl="J, ind="J, bel="G, am, cubl="H, 
ed="_, el="", clear="L, cup="T%pl%c%p2%c, 
cols#80, lines#24, cufl="X, cuul="Z, home="], 

3000 032 001 \0 025 \0 \b \0 212 \0 ” \0 m i c r 

020 oterm|act4 |micro 
040 term act iv\0\0 001 \0 \0 

060 \0 \0 \0 \0 \0 \0 \0 \0 \0 \0 \0 \0 \0 \0 \0 \0 

100 \0 \0 P \0 377 377 030 \0 377 377 377 377 377 377 377 377 

120 377 377 377 377 \0 \0 002 \0 377 377 377 377 004 \0 006 \0 

140 \b \0 377 377 377 377 \n \0 026 \0 030 \0 377 377 032 \0 

160 377 377 377 377 034 \0 377 377 036 \0 377 377 377 377 377 377 

200 377 377 377 377 377 377 377 377 377 377 377 377 377 377 377 377 

* 

520 377 377 377 377 \0 377 377 377 377 377 377 377 377 377 377 
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540 377 377 377 377 377 377 007 \0 \r \0 \f \0 036 \0 037 \0 

560 024 % p 1 % c % p 2 % c \0 \n \0 035 \0 

600 \b \0 030 \0 032 \0 \n \0 

Some limitations: the total size of a compiled description cannot 

exceed 4096 bytes; the name field cannot exceed 128 bytes. 



Files 



/usrAib/terminfo/*/* compiled terminal capability data base 



See Also 



terminfo(M), terminfo(S), tic(C) 
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timezone 

set default system time zone 
Syntax 

/etc/TIMEZONE 

Description 



This file sets and exports the time zone environmental variable TZ. 

This file is “dotted” into other files that must know the time zone, 

including /etc/cshrc, /etc/proflle, /etc/rc2, .profile. 

TZ contains the following information: 

(sss) One to nine letters designating the standard time zone. 

(n) Number of hours past Greenwich mean time for the stan- 

dard time (partial hours are valid e.g. 12:30:01). Positive 
hours are west of Greenwich, negative numbers are east of 
Greeenwich. 

(ddd) One to nine letters designating the local daylight savings 
time (summer time) zone. If not present, summer time is 
assumed not to apply. 

(m) Number of hours past Greenwich mean time for the sum- 

mer time (partial hours are valid e.g. 11:30:01). Positive 
hours are west of Greenwich, negative numbers are east of 
Greeenwich. If m is not given, the distance to GMT dur- 
ing summer time is assumed to be one hour less than dur- 
ing standard time. 

(start) The rule defining the day summer time begins. In the 
southern hemisphere, the ending day will be earlier in the 
year than the starting day. 

(end) The rule defining the day summer time ends. 

(time) The time of day the change to and from summer time 

occurs. The default is 02:00:00 local time. 
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The rules for defining the start and end of summer time are as fol- 
lows: 

]n 1 based Julian day n{l<n< 365)* 

n 0 based Julian day n(0^n< 364)* 

'Wn.d day d{0<d< 6)** of week n(l<n< 53)t 

Mm.n.d day d of week n(\ <n< 5)t of month m (1 < m < 12) 



* Leap days (February 29) are never counted; that is, February 28 
(J59) is immediately followed by March 1 (J60) even in leap years. 

** Sunday is the first day of the week (0). If d is omitted, Sunday is 
assumed. Note that dis optional. 

t The 5th week of the month is always the last week containing day 
d, whether there are actually 4 or 5 weeks containing day d. 

t The 53rd week of the year is always the last week containing day 
d, whether there are actually 52 or 53 weeks containing day d. 

If start and end are omitted, current U.S. law is assumed. 

Examples 



A simple setting for New Jersey could be 
TZ=’EST5EDT’ 

where EST is the abbreviation for the main time zone, 5 is the 
difference, in hours, between GMT (Greenwich Mean Time) and the 
main time zone, and EDT is the abbreviation for the alternate time 
zone. 

The most complex representation of the same setting, for the year 
1986, is 



TZ=’EST5:00:00EDT4:00:00; 117/2:00:00,299/2:00:00’ 

where EST is the abbreviation for the main time zone, 5:00:00 is the 
difference, in hours, minutes, and seconds between GMT and the main 
time zone, EDT is the abbreviation for the alternate time zone, 
4:00:00 is the difference, in hours, minutes, and seconds between GMT 
and the alternate time zone, 117 is the number of the day of the year 
(Julian day) when the alternate time zone will take effect, 2:00:00 is 
the number of hours, minutes, and seconds past midnight when the 
alternate time zone will take effect, 299 is the number of the day of the 
year when the alternate time zone will end, and 2:00:00 is the number 
of hours, minutes, and seconds past midnight when the alternate time 
zone will end. 
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A southern hemisphere setting such as the Cook Islands could be 

TZ=’KDT9:30KST10:00;64/5:00,303/20:00’ 

This setting means that KDT is the abbreviation for the main time 
zone, KST is the abbreviation for the alternate time zone, KST is 9 
hours and 30 minutes later than GMT, KDT is 10 hours later than GMT, 
the starting date of KDT is the 64th day at 5 AM, and the ending date 
of KDT is the 303rd day at 8 PM. 

Starting and ending times are relative to the alternate time zone. If 
the alternate time zone start and end dates and the time are not pro- 
vided, the days for the United States that year will be used and the 
time will be 2 AM. If the start and end dates are provided but the time 
is not provided, the time will be midnight. 

Note that in most installations, TZ is set to the correct value by default 
when the user logs on, via the local ! etc! profile file [see profile (¥)]. 

See Also 



ctime(S), profile(F), environ(M), TZ(M), rc2(ADM) 

Notes 



Setting the time during the interval of change from the main time zone 
to the alternate time zone or vice versa can produce unpredictable 
results. 

Standards Conformance 



timezone is conformant with: 

The X/Open Portability Guide II of January 1987. 
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top, top.next 

the Micnet topology files 
Description 



These files contain the topology information for a Micnet network. 
The topology information describes how the individual systems in the 
network are connected, and what path a message must take from one 
system to reach another. Each file contains one or more lines of text. 
Each line of text defines a connection or a communication path. 

The top file defines connections between systems. Each line lists the 
machine names of the connected systems, the serial lines used to make 
the connection, and the speed (baud rate) of transmission between the 
systems. Each line has the following format: 

machine 1 tty la machine2 tty2a speed 

machinel and machinela are the machine names of the respective sys- 
tems (as given in the systemid files). The ttys are the device names 
(e.g., ttyla) of the connecting serial lines. The speed must be an 
acceptable baud rate (e.g., 110, 300, ..., 19200). 

The top.next file contains information about how to reach a particular 
system from a given system. There may be several lines for each sys- 
tem in the network. Each line lists the machine name of a system, fol- 
lowed by the machine name of a system connected to it, followed by 
the machine names of all the systems that may be reached by going 
through the second system. Such a line has the form: 

machinel machine2 machines [machine4]... 

The machine names must be the names of the respective systems (as 
given by the first machine name in the systemid files). 

The top.next file must be present even if there are only two computers 
in the network. In such a case, the file must be empty. 

In the top and top.next files, any line beginning with a number sign 
(#) is considered a comment, and is ignored. 

Files 



/usr/lib/mail/top 

/usr/lib/mail/top.next 
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See Also 



TOP (F) 



netutil(ADM), systemid(F) 
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types 

primitive system data types 

Syntax 



#include <sys/types.h> 

Description 



The data types defined in the include file <sys/types.h> are used in 
UNIX system code; some data of these types are accessible to user 
code. 

The form daddrj is used for disk addresses except in an inode on 
disk, see filesystem (F). Times are encoded in seconds since 00:CX):00 
GMT, January 1, 1970. The major and minor parts of a device code 
specify kind and unit number of a device and are installation- 
dependent. Offsets are measured in bytes from the beginning of a file. 
The label J variables are used to save the processor state while 
another process is running. 

See Also 



filesystem(F) 

Standards Conformance 



types is conformant with: 

The X/Open Portability Guide II of January 1987. 
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unistd 

file header for symbolic constants 

Syntax 

#include <unistd.h> 

Description 



The header file <unistd.h> lists the symbolic constants and structures 
not already defined or declared in some other header file. 



/* Syrnbolic constants for the "access” routine: */ 



#define R_OK 
#def ine W_OK 
#define X_OK 
#define F OK 



4 /*Test for Read permission */ 

2 /*Test for Write permission */ 

1 /*Test for execute permission */ 
0 /*Test for existence of File ♦/ 



#define FJLJLOCK 0 
#define F_LOCK 1 
#def ine FJTLOCX 2 
#define F TEST 3 



/♦Uilock a previously locked region ♦/ 

/♦Lock a region for exclusive use */ 

/♦Test and lock a region for exclusive use ♦/ 
/♦Test a region for other processes locks ♦/ 



/♦Syrrbolic constants for the "Iseek" routine: ♦/ 



#define SEEKJSET 0 
#define SEEKJCUR 1 
#def ine SEEK END 2 



/♦ Set file pointer to 
/♦ Set file pointer to 
/♦ Set file pointer to 



"offset” ♦/ 

current plus "offset” ♦/ 
EOF plus "offset” ♦/ 



/♦Path names : ♦/ 

Idefine GF_PATH "/etc/group" /♦Path name of the group file ♦/ 

#define PF_PATH ”/etc/passwd” /♦Path name of the passwd file ♦/ 



Standards Conformance 



unistd is conformant with: 

The X/Open Portability Guide II of January 1987. 
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utmp, wtmp 

formats of utmp and wtmp entries 

Syntax 

#include <sys/types.h> 

#include <utmp.h> 

Description 

These files, which hold user and accounting information for such com- 
mands as who(C\ write (C\ and login(M), have the following struc- 
ture as defined by <utmp.h>: 

#define UIMP_FILE "/etc/utnp" 

#define WTMP_FIIE "/etc/wtirp" 

#define ut_name utjuser 

struct utirp { 



char 


ut user [83; 


/* User login narte ♦/ 


char 


ut_id[4]; 


/* usually line # */ 


char 


ut__line [12] ; 


/* device narre (console, Inxx) ♦/ 


short 


ut_pid; 


/* process id */ 


short 


ut_type; 


/* type of entry ♦/ 


struct 


exit_status { 




short 


ejtermination; 


/* Process tennination status */ 


short 


e_exit; 


/* Process exit status */ 


} ut_exit; 




/* The exit status of a process 
marked as DEAD_PROCESS . */ 


timejt 


ut_time; 


/* time entry was made */ 



}; 

/* Definitions for ut_type */ 



#define EiyPTY 0 

#define RUN_LVL 1 

#define BOOTJTIME 2 

#define OID_TIME 3 

#define NEW TIME 4 



#define INIT_PROCESS 5 /* Process spawned by "init" */ 

#define I£GIN_PROCESS 6 /♦ A "getty*’ process waiting for login */ 

#define USER_PROCESS 7 /* A user process */ 

idefine DEAD_PROCESS 8 

#define AOOCXJNTING 9 

#define UTMAXTYPE AOCXXJNTING /♦ Largest legal value of utjtype */ 
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/♦ Special strings or fomats used in the ”ut_line” field when ♦/ 
/* accounting for something other than a process */ 

/* No string for the ut_line field can be more than 11 chars + */ 
/* a NULL in length */ 

#define RUNLVL_MSG "run~level %c" 

#define BOOT_MSG "system boot” 

#define OTIME_MSG "old time” 

#define NTIME_MSG "new time" 

Files 



/usr/include/utmp.h 

/etc/utmp 

/etc/wtmp 

See Also 



getut(S), login(M), who(C), write(C) 

Standards Conformance 



utmp and wtmp are conformant with: 

The X/Open Portability Guide II of January 1987. 
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x.out 

format of XENIX link editor output 
Syntax 

#include <x.out.h> 

Description 



The output of the XENIX link editor, called the x.out or segmented 
x.out format, is defined by the files /usr/include/x.outh and 
/usr/include/sys/relsym.h. The x.out file has the following general 
layout: 

1 . Header. 

2. Extended header. 

3. File segment table (for segmented formats). 

4. Segments (Text, Data, Symbol, and Relocation). 

In the segmented format, there may be several text and data segments, 
depending on the memory model of the program. Segments within the 
file begin on boundaries which are multiplies of 512 bytes as defined 
by the file’s pagesize. 

Format 









The main and extended header structures. 

For x.out segmented (XE_SEG) : 

1) fields marked with (s) must contain sums of xs_psize for 
non-memory images, or xs_vsize for memory images. 

2) the contents of fields marked with (u) are undefined. 



struct xexec { /* x.out header */ 

unsigned short x_magic; /* magic number */ 
unsigned short x_ext; /* size of header extension */ 
/* size of text segment (s) */ 

/* size of initialized data (s) */ 
size of uninitialized data (s) */ 
/* size of symbol table (s) */ 
relocation table length (s) */ 
entry point, machine dependent */ 



long 


x_text; 


long 


x_data; 


long 


x_bss; /* 


long 


X syms; 


long 


x_reloc; /* 


long 


x_entry; /* 
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char x_cpu; /* cpu type & byte/word order */ 

char x_relsym; /* relocation & symbol format (u) */ 

unsigned short x_renv; /* run-time environment */ 



struct xext { /* x.out header extension 

long xe_trsize; /* size of text relocation (s) */ 

long xe_drsize; /* size of data relocation (s) */ 

long xe_tbase/ /* text relocation base (u) */ 

long xe__dbase; /* data relocation base (u) */ 

long xe_stksize; /* stack size (if XE_FS set) */ 

/* the following must be present if XE_SEG */ 
long xe_segpos; 1 '^ segment table position */ 

long xe_segsize; /* segment table size '^/ 

long xe_mdtpos; /* machine dependent table position */ 
long xe_mdtsize; /* machine dependent table size */ 

char xejndttype; /* machine dependent table type */ 

char xe_pagesize; /* file pagesize, in multiples of 512 */ 
char xe_ostype; /* operating system type "*/ 

char xe_osvers; /* operating system version */ 

unsigned short xe_eseg; /* entry segment, machine dependent 
unsigned short xe_sres; /* reserved */ 



struct xseg { /* x.out segment table entry */ 

unsigned short xs_type; /* segment type */ 
unsigned short xs_attr; /* segment attributes */ 
unsigned short xs_seg; /* segment number */ 
char xs_align; /* log base 2 of alignment */ 
char xs_cres; /* unused */ 

long xs_filpos; /* file position */ 

long xs_psize; /* physical size (in file) */ 

long xs_vsize; /* virtual size (in core) */ 

long xs_rbase; /* relocation base address /off set */ 

unsigned short xs_noff; /* segment name string table offset */ 

unsigned short xs_sres; /* unused */ 

long xs_lres; /* unused */ 



struct xiter { 

long xi_size; 

long xi_rep; 

long xi_of f set ; 

In- 
struct xlist { /* xlist structure for xlist(3). */ 

unsigned short xl_type; /* syirbol type */ 
unsigned short xl_seg; /* file segment table index */ 
long xl_value; /* symbol value */ 

char "^xl_name; /* pointer to asciz name */ 



struct aexec { /* a. out header */ 



/* x.out iteration record */ 

/* source byte count */ 

/* replication count */ 

/* destination offset in segment */ 
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unsigned short 


xa_magic; 


/* 


unsigned short 


xa_text; 


/* 


unsigned short 


xa_data; 


/* 


unsigned Short 


xa_bss; 


/* 


unsigned short 


xa_syms; 


/* 


unsigned short 


xa_entry; 


/* 


unsigned short 


xa_unused; 


/* 


unsigned short 


xa_flag; 


/* 



magic number */ 

size of text segment */ 

size of initialized data */ 

size of uninitialized data '^1 

size of symbol table */ 

entry point */ 

not used */ 

relocation info stripped */ 



struct nlist { 

char n_name [ 8 ] ; 

int n_type; 
unsigned n_value; 

}; 



/* nlist structure for nlist (3) . */ 
/* symbol name */ 

/* type flag */ 

/* value */ 



struct bexec { /* b.out header */ 

long xbjnagic; /* magic number */ 

long xb_text; /* text segment size */ 

long xb_data; /* data segment size */ 

long xb_bss; /* bss size */ 

long xb_syms; /* symbol table size */ 

long xb_trsize; /* text relocation table size */ 

long xb_drsize; /* data relocation table size */ 

long xb_entry; /* entry point */ 

}; 



See Also 



masm(CP), Id(GP), ntn(CP), strip(CP), xlist(S) 

Value Added 



x.out is an extension of AT&T System V provided in Altos UNIX Sys- 
tem V. 
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xbackup 

XENIX incremental dump tape format 
Description . 



The xbackup and xrestore commands are used to write and read incre- 
mental dump magnetic tapes. 

The backup tape consists of a header record, some bit mask records, a 
group of records describing file system directories, a group of records 
describing file system files, and some records describing a second bit 
mask. 

The header record and the first record of each description have the for- 
mat described by the structure included by: 

#include <dumprestor.h> 

Fields in the dumprestor structure are described below. 

NTREC is the number of 512 byte blocks in a physical tape record. 
MLEN is the number of bits in a bit map word. MSIZ is the number of 
bit map words. 

The TS_ entries are used in the cjype field to indicate what sort of 
header this is. The types and their meanings are as follows: 



TS.TAPE 


Tape volume label. 


TSJNODE 


A file or directory follows. The cjdinode field is a 
copy of the disk inode and contains bits telling what 
sort of file this is. 


TS_BITS 


A bit mask follows. This bit mask has one bit for each 
inode that was backed up. 


TS_ADDR 


A subblock to a file (TSJNODE). See the description 
of cjoount below. 


TS_END 


End of tape record. 


TS_CLRI 


A bit mask follows. This bit mask contains one bit for 
all inodes that were empty on the file system when 
backed up. 


MAGIC 


All header blocks have this number in cjnagic . 
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CHECKSUM Header blocks checksum to this value. 

The fields of the header structure are as follows: 

c_type The type of the header. 

c_date The date the backup was taken. 

c_ddate The date the file system was backed up. 

c__volume The current volume number of the backup. 

c_tapea The current block number of this record. This is count- 

ing 512 byte blocks. 

cjnumber The number of the inode being backed up if this is of 
type TSJNODE. 

c_magic This contains the value MAGIC above, truncated as 
needed. 

c_checksum This contains whatever value is needed to make the 
block sum to CHECKSUM. 

c_dinode This is a copy of the inode as it appears on the file sys- 
tem. 

c_count The following count of characters describes the file. 

A character is zero if the block associated with that 
character was not present on the file system; other- 
wise, the character is nonzero. If the block was not 
present on the file system no block was backed up and 
it is replaced as a hole in the file. If there is not 
sufficient space in this block to describe all of the 
blocks in a file, TS_ADDR blocks will be scattered 
through the file, each one picking up where the last 
left off. 

c_addr This is the array of characters that is used as described 

above. 

Each volume except the last ends with a tapemark (read as an end of 
file). The last volume ends with a TS_END block and then the tape- 
mark. 

The structure idates describes an entry of the file where backup his- 
tory is kept. 

See Also 

xbackup(ADM), xrestore(ADM), filesystem(F) 
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xbackup is an extension of AT&T System V provided in Altos UNIX 
System V. 
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xprtab 

system tty transparent printer map file 
Description 



The xprtab file is used by xprsetup{PiDM) to map transparent printer 
device nodes to tty device nodes. The xprtab file is normally main- 
tained and updated using pcw(ADM), the Altos port configuration util- 
ity. If the xprtab file is changed manually, the transparent printer tty 
mapping change will not take place until xprsetup{kt>M) is executed. 

Each entry in the xprtab file contains three fields separated by white 
space: 



xprnum ttypathname termtype 
Each field is described below: 



xprnum This field contains a unique decimal number in the 
range 1 through 99. This number represents the minor 
device number of the transparent printer device node. 
Transparent printer device node names range from 
/dev/xpr/xprOl to /dev/xpr/xpr99. 



ttypathname This field contains the absolute pathname of the associ- 
ated tty device node (e.g., /dev/tty la). 

termtype This field contains the terminal terminfo(M) name of 
the terminal connected to the tty port in field two. For 
tty ports connected to modems this field should contain 
the termtype dialup. 



Files 



/etc/xprtab 

See Also 



xprsetup(ADM), pcu(ADM) 

Value Added 



xprtab is an extension to AT&T UNIX System V provided in Altos 
UNIX System V. 
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Permuted Index 

Commands, System Calls, Library Routines and File Formats 



This permuted index is derived from the “Name” description lines found on each 
reference manual page. Each index line shows the title of the entry to which the line 
refers, followed by the reference manual section letter where the page is found. 

To use the permuted index search the middle column for a key word or phrase. The right 
hand column contains the name and section letter of the manual page that documents 
the key word or phrase. The left column contains additional useful information about 
the command. Commands or routines are also listed in the context of the index line, 
followed by a colon (:). This denotes the “beginning” of the sentence. Notice that in 
many cases, the lines wrap, starting in the middle column and ending in the left column. 
A slash (/) indicates that the description line is truncated. 



functions of DASI 300/ 
functions of DASI/ 300: 
functions of DASI 
of DASI 300/ 300: 300, 
of DASI 300 and 
cofleonv: Convert 
13tol, ltol3: Converts between 
TEKTRONIX 4014 terminal 
paginator for the TEKTRONIX 
the DASI 450 terminal 
functions of the DASI 
accepts a number of 
/object downloader for the 
between long integer and base 
i286emul: emulate 
x286emul: emulate XENIX 
Object Modules. 86rel: Intel 
asx: XENIX 
Format for Object Modules, 
long integer and base 64 ASCII. 
Format of UUCP dial-code 

value. 

abs: Returns an integer 
and/ /fabs, ceil, fmod: Performs 
integer, labs: Returns the 
blocks. 

Synchronizes shared data 
files, settime: Changes the 
utime: Sets file 



300: 300, 300s - handle special . 
300, 300s - handle special . . . 
300 and 300s terminals /special 
300s - handle special functions 
300s terminals /functions . . . 
386 COFF files to XENIX format. 
3-byte integers and long/ . . . 
4014: paginator for the .... 

4014 terminal 4014: 

450: handle special functions of 
450 terminal /handle special . . 

512-byte blocks 

5620 DMD terminal 

64 ASCII. a641, 164a: Converts . 

80286 

80286 

8086 Relocatable Format for . . 
8086/1 86/286/386 Assembler. . 
86rel: Intel 8086 Relocatable . . 
a641, 164a: Converts between . . 
abbreviations file, dialcodes: . . 
abort: Generates an lOT fault, 
abs: Returns an integer absolute 

absolute value 

absolute value, floor, ceiling . . 
absolute value of a long .... 
accepts a number of 5 1 2-byte 
access, sdgetv, sdwaitv: . . . 

access and modification dates of 
access and modification times. 



300(C) 

300(C) 

300(C) 

300(C) 

300(C) 

coffconv(M) 

13tol(S) 

4014(C) 

4014(C) 

450(C) 

450(C) 

login(M) 

wtinit(ADM) 

a641(S) 

i286emul(C) 

x286emul(C) 

86rel(F) 

asx(CP) 

86rel(F) 

a641(S) 

dialcodes(F) 

abort(S) 

abs(S) 

abs(S) 

floor(S) 

labs(DOS) 

login(M) 

sdgetv(S) 

settime(ADM) 

utime(S) 
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Permuted Index 



a file, touch: Updates access and modification times of . touch(C) 

of a file, access: Determines accessibility . access(S) 

dosls, dosrm, dosrmdir: Access DOS files. dos(C) 

directory, chmod: Changes the access permissions of a file or . . chmod(C) 

Idfcn: common object file access routines Idfcn(F) 

sulogin: access single-user mode sulogin(ADM) 

filesystems for optimal access time /copy UNIX .... dcopy(ADM) 
a/ Aibwaitsem: Awaits and checks access to a resource governed by . waitsem(S) 
sdenter, sdleave: Synchronizes access to a shared data segment. . sdenter(S) 
sputl, sgetl: Accesses long integer data in a/ . . sputl(S) 

endutent, utmpname: Accesses utmp file entry getut(S) 

access: Determines accessibility of a file access(S) 

csplit: Splits files according to context csplit(C) 

Enables or disables process accounting, acct: acct(S) 

accton: T\ims on accounting accton(ADM) 

acctprcl, acctprc2 - process accounting acctprc: acctprc(ADM) 

runacct: run daily accounting . runacct(ADM) 

tumacct - shell procedures for accounting /shutacct, startup, . . acctsh(ADM) 
/accton, acctwtmp - overview of accounting and miscellaneous/ . . acct(ADM) 
of accounting and miscellaneous accounting commands /- overview acct(ADM) 

diskusg: generate disk accounting data by user ID ... . diskusg(ADM) 

acct: Format of per-process accounting file acct(F) 

Searches for and prints process accounting files, acctcom: .... acctcom(ADM) 

acctmerg: merge or add total accounting files acctmerg(ADM) 

command summary from per-process accounting records acctcms: . . . acctcms(ADM) 

wtmpfix: manipulate connect accounting records /fwtmp, . . . fwtmp(ADM) 

imacct: Generate an IMAGEN accounting report imacct(C) 

accton, acctwtmp - overview of/ acct: acctdisk, acctdusg, acct(ADM) 

process accounting, acct: Enables or disables .... acct(S) 
accounting file, acct: Format of per-process ... acct(F) 
per-process accounting records acctcms: command summary from . acctcms(ADM) 
process accounting files, acctcom: Searches for and prints . acctcom (ADM) 
acctwtmp - overview of/ acct: acctdisk, acctdusg, accton, .... acct(ADM) 
overview of/ acct: acctdisk, acctdusg, accton, acctwtmp - . . . acct(ADM) 

accounting files acctmerg: merge or add total . . . acctmerg(ADM) 

acct: acctdisk, acctdusg, accton, acctwtmp - overview of/ . acct(ADM) 

accton: T\ims on accounting. . . . accton(ADM) 

process accounting acctprc: acctprcl, acctprc2 - . . . acctprc(ADM) 

accounting acctprc: acctprcl, acctprc2 - process . . . acctprc(ADM) 

acctprc: acctprcl, acctprc2 - process accounting . . acctprc(ADM) 

dodisk, lastlogin, monacct,/ acctsh: chargefee, ckpacct, . . . acctsh(ADM) 
acctdisk, acctdusg, accton, acctwtmp - overview of/ acct: . . acct(ADM) 

sin, cos, tan, asin, acos, atan, atan2: Performs/ . . . trig(S) 

initcond: special security actions for init and getty initcond(ADM) 

/interface for audit subsystem activation, termination, auditcmd(ADM) 

killall: kill all active processes killall(ADM) 

Prints current sees file editing activity, sact: sact(eP) 

information about system activity, uptime: Displays .... uptime(e) 
report process data and system activity timex: time a command; . timex(ADM) 

sag: system activity graph sag(ADM) 

sar, sal, sa2, sadc - system activity report package sar: . . . sar(ADM) 
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debugger. 

vdutil: 

add.vd: 

device driver/ idinstall: 
XENDC-style/ addxusers: 
kernel configuration/ idaddld: 
acctmerg: merge or 
paramters to be adjusted when 
Copies bytes from a specific 
checkaddr: MMDF 
nl: 

lineprinters. Ipinit: 
swapadd: 
pulenv: Changes or 
match system/ 
sees files. 
LP print service Ipfilter: 
LP print service Ipforms: 
admin: Creates and 
netutil: 
uuinstall: 
network listener service 
/Menu driven at and cron 
Menu driven Ip print service 
auditsh: Menu driven audit 
backupsh: Menu driven backup 
sysadmsh: Menu driven system 
uadmin: 
uadmin; 
swap: swap 
authorization/ authtsh: 
alarm: Sets a process* 
clock. 

/MMDF hashed database of 
mmdfalias: converts XENIX-style 
bikctl: 

malloc, free, realloc, calloc: 
bik: Changes data segment space 
file, inittab: 
Generates programs for lexical 
reduce: perform audit data 
temporarily privs: print 
link editor output. 

libraries, 
dc: Invokes an 
cpio: Format of cpio 
the names of files on a backup 
Otar: original tape 
pax: portable 
ar: 



adb: Invokes a general-puipose . . 

add a virtual disk . 

add a virtual disk 

add, delete, update, or get .... 
add new user accounts given a/ . . 
add or remove line disciplines from 
add total accounting files .... 

adding more memory 

address, movedata: 

address verification program . . . 
Adds line numbers to a file. . . . 
Adds, reconfigures and maintains . 

Adds swap area 

adds value to environment. . . . 
adjusts tunable parameters to . . 
admin: Creates and administers . . 
administer filters used with the . . 
administer forms used with the . . 

administers SCCS files 

Administers the XENIX network. . 
Administers UUCP control files, 
administration nlsadmin: . . . . 

administration utility 

administration utility Ipsh: . . . 

administration utility 

administration utility 

administration utility. ...... 

administrative control 

administrative control 

administrative interface 

administrator interface for .... 

alarm clock 

alarm: Sets a process* alarm . . . 
alias and routing information. . . 

aliases file to MMDF/ 

Allocates data in a far segment. . . 

Allocates main memory 

allocation, sbik, 

Alternative login terminals . . . 

analysis, lex: 

analysis and reduction 

and/or restrict privileges 

a.ouf Format of assembler and . . 

ar: Archive file format 

ar: Maintains archives and .... 
arbitrary precision calculator. . . 

archive 

archive, dumpdir: Prints .... 

archive command 

archive exchange 

Archive file format 



adb(CP) 

vdutil(ADM) 

add.vd(ADM) 

idinstall(ADM) 

addxusers(ADM) 

idaddld(ADM) 

acctmerg(ADM) 

memtune(F) 

movedata(DOS) 

checkaddr(ADM) 

nl(Q 

Ipinit(ADM) 

swapadd(S) 

putenv(S) 

idmemtune(ADM) 

admin(CP) 

lpfilter(ADM) 

Ipforms(ADM) 

admin(CP) 

netutil(ADM) 

uuinstall(ADM) 

nlsadmin(ADM) 

atcronsh(ADM) 

Ipsh(ADM) 

auditsh(ADM) 

backupsh(ADM) 

sysadmsh(ADM) 

uadmin(ADM) 

uadmin(S) 

swap(ADM) 

authtsh(ADM) 

alarm(S) 

alarm(S) 

dbmbuild(ADM) 

mmdfalias(ADM) 

bikcti(S) 

malloc(S) 

sbik(S) 

inittab(F) 

lex(CP) 

reduce(ADM) 

privs(Q 

a.out(F) 

ar(F) 

ar(CP) 

dc(C) 

cpio(F) 

dumpdir(Q 

otar(C) 

pax(C) 

ar(F) 
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tar: archive format tar(F) 

ar: Maintains archives and libraries ar(CP) 

tar: Archives files tar(Q 

cpio: Copies file archives in and out cpio(C) 

ranlib: Converts archives to random libraries. . . . ranlib(CP) 

swapadd: Adds swap area swapadd(S) 

output of a argument list. /Prints formatted . . vprintf(S) 

varargs: variable argument list varargs(S) 

getopt: Gets option letter from argument vector getopt(S) 

echo: Echoes arguments echo(Q 

expr: Evaluates arguments as an expression. . . . expr(Q 
between long integer and base 64 ASCII. a641, 164a: Converts . . . a641(S) 
tzset: Converts date and time to ASCII, ^gmtime, asctime, .... aime(S) 

ascii: Map of the ASCII character set ascii(M) 

character set. ascii: Map of the ASQI ascii(M) 

atof, atoi, atol: Converts ASCII to numbers atof(S) 

pscat: ASCII-to-PiostScript filter .... pscat(C) 

and/ ctime, localtime, gmtime, asctime, tzset: Converts date . . . ctime(S) 

Performs/ sin, cos, tan, asin, acos, atan, atan2: trig(S) 

commands, help: Asks for help about SCCS .... help(CP) 

time of day. asktime: Prompts for the correct . asktime(ADM) 

asx: XENIX 8086/186/286/386 Assembler asx(CP) 

masm: Invokes the XENIX assembler masm(CP) 

output. a.out: Format of assembler and link editor .... a.out(F) 

program, assert: Helps verify validity of . . assert(S) 
deassigns devices, assign, deassign: Assigns and . . assign(C) 

assign, deassign: Assigns and deassigns devices. . . assign(C) 

setbuf, setvbuf: Assigns buffering to a stream. . . setbuf(S) 

setkey: Assigns the function keys setkey(C) 

Qose the event queue and all associated devices. ev_close: . . ev_close(S) 

Assembler, asx: XENIX 8086/186/286/386 . . asx(CP) 

a later time, at, batch: Executes commands at . at(C) 

sin, cos, tan, asin, acos, atan, atan2: Performs/ trig(S) 

sin, cos, tan, asin, acos, atan, atan2: Performs trigonometric/ . . trig(S) 
cron administration utility atcronsh: Menu driven at and . . . atcronsh(ADM) 

to numbers, atof, atoi, atol: Converts ASCII . . atof(S) 
double-precision/ strtod, atof: Converts a string to a .... strtod(S) 
numbers, atof, atoi, atol: Converts ASCII to . . . atof(S) 

integer, strtol, atol, atoi: Converts string to strtol(S) 

integer, strtol, atol, atoi: Converts string to ... strtol(S) 
atof, atoi, atol: Converts ASCII to numbers. . atof(S) 
filesystem backup/ restore: AT&T UNIX incremental .... restore(ADM) 

QIC-24/QIC-02 tape/ tapecntl: AT&T tape control for tapecntl(C) 

xt: multiplexed tty driver for AT&T windowing terminals . . . xt(HW) 

/Print file to printer attached to a serial console . . . consoleprint(ADM) 

Iprint: Print to a printer attached to the user’s terminal . . Iprint(C) 

data segment, sdget, sdfree: Attaches and detaches a shared . . sdget(S) 

tunable parameter idtune: attempts to set value of a .... idtune(ADM) 
auditsh: Menu driven audit administration utility .... auditsh(ADM) 
device audit: audit subsystem interface . . audit(ADM) 
by the audit/ auditd: read audit collection files generated . . auditd(ADM) 
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reduction reduce: perform 
events dlvr_audit: produce 
auditemd: command interface for 
files generated by the 
audit: 

audit subsystem activation^ 
files generated by the audit/ 
chg_audit: enables and disable 
administration utility 

consistency of Authentication/ 
checker 

/examine system files against 
authcap: 

check internal consistency of 
/administrator interface for 
for authorization subsystem 
the system, 
schedule: Database for 
autoboot: 

resource/ waitsem, nbwaitsem: 
processes, wait: 
a pattern in a file, 
wait: Awaits completion of 
Performs incremental file system 
error-checking filesystem 
incremental filesystem 
backupsh: Menu driven 
Prints the names of files on a 
sddate: Prints and sets 
/Default 
backup: performs UNIX 
format, 
file system backup, 
backup functions 
incremental filesystem 
Database for automated system 
periodic semi-automated system 
administration utility 
vdutil: repair 
vdutil: display 
fixed disk for flaws and creates 
flaws and creates bad track/ 

Terminal capability data 
and sets the configuration data 
and sets the configuration data 
terminal capability data 
between long integer and 
names from pathnames, 
later time, at. 



audit data analysis and .... 
audit records for subsystem . . 
audit subsystem activationy . . 
audit subsystem and /collection 
audit subsystem interface device 
auditemd: command interface for 
auditd: read audit collection . . 
auditing for the next session . . 
auditsh: Menu driven audit . . 
authcap: authentication database 
authek: check internal .... 
authekre: trusted computing base 
authentication database .... 
authentication database .... 
Authentication database authek: 
authorization subsystem .... 
authtsh: administrator interface . 
autoboot: Automatically boots 
automated system backups . . . 
Automatically boots the system. 
Awaits and checks access to a 
Awaits completion of background 
awk: Searches for and processes 

background processes 

backup, backup: 

backup fsave: Interactive, . . . 
backup. /Performs XENIX . . . 
backup administration utility . . 
backup archive, dumpdir: . . . 

backup dates 

backup device information. . . 

backup functions 

backup: Incremental dump tape . 
backup: Performs incremental 
backup: performs UNIX .... 
backup restore /UNIX .... 

backups schedule: 

backups fsphoto: Performs . . 
backupsh: Menu driven backup . 
bad block on a mirrored disk . . 
bad blocks for a mirrored disk 
bad track table, badtrk: Scans 
badtik: Scans fixed disk for . . 
banner: Prints large letters. . . . 

base, termcap: 

base, emos: Displays 

base, emos: Displays 

base, "terminfo:" 

base 64 ASCII. /164a: Converts . 
basename: Removes directory 
batch: Executes commands at a . 



reduce(ADM) 

dlvr_audit(ADM) 

auditcmd(ADM) 

auditd(ADM) 

audit(ADM) 

auditcmd(ADM) 

auditd(ADM) 

chg_audit(ADM) 

auditsh(ADM) 

authcap(ADM) 

authck(ADM) 

tcbck(ADM) 

integrity(ADM) 

authcap(ADM) 

authck(ADM) 

authtsh(ADM) 

authtsh(ADM) 

autoboot(ADM) 

schedule(ADM) 

autoboot(ADM) 

waitsem(S) 

wait(C) 

awk(C) 

wait(C) 

backup(ADM) 

fsave(ADM) 

xbackup(ADM) 

backupsh(ADM) 

dumpdir(C) 

sddate(C) 

archive(F) 

backup(ADM) 

backup(F) 

backup(ADM) 

backup(ADM) 

restore(ADM) 

schedule(ADM) 

fsphoto(ADM) 

backupsh(ADM) 

vdutil(ADM) 

vdutil(ADM) 

badtrk(ADM) 

badtiic(ADM) 

banner(C) 

termcap(M) 

cmos(HW) 

cmos(HW-86) 

terminfo(M) 

a641(S) 

basename(C) 

at(C) 
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be: Invokes a calculator bc(C) 

initialization/ bre: bre, bcheckrc - system brc(ADM) 

for diff. bdiff. Compares files too large . . bdiir(C) 

bdos: Invokes a DOS system call. . bdos(DOS) 

cb: Beautifies C programs cb(CP) 

jOJlJn, yO, yl, yn: Performs Bessel functions, bessel bessel(S) • 

Performs Bessel functions, bessel, jOJlJn, yO, yl, yn: . . . bessel(S) 

bfs: Scans big files bfs(C) 

mail uudecode: decode a binary file for transmission via . . uuencode(C) 

mail uuencode: encode a binary file for transmission via . . uuencode(C) 

fixhdr: Changes executable binary file headers fixhdr(C) 

selected parts of executable binary files, hdr: Displays .... hdr(CP) 

fread, fwrite: Performs buffered binary input and output fread(S) 

bsearch: Performs a binary search bsearch(S) 

tfind, tdelete, twalk: Manages binary search trees, tsearch, . . . tsearch(S) 

Creates an instance of a binary semaphore, creatsem: . . . creatsem(S) 

Removes symbols and relocation bits, strip: strip(CP) 

rmb: remove extra blank lines from a file ...... rmb(M) 

shutdn: Flushes block I/O and halts the CPU. . . . shutdn(S) 

cmchk: Reports hard disk block size cmchk(C) 

accepts a numter of 512-byte blocks. login(M) 

df: Report number of free disk blocks df(C) 

Calculates checksum and counts blocks in a file, sum: sum(C) 

fdswap: Swaps default boot floppy drive fdswap(ADM) 

boot: XENIX boot program boot(HW) 

boot: XENIX boot program. . . . boot(HW) 

autoboot: Automatically boots the system. autoboot(ADM) 

initialization procedures bre: bre, bcheckrc - system brc(ADM) 

initialization procedures bre: bre, bcheckrc - system .... brc(ADM) 
allocation, sbrk, brk: Changes data segment space . sbrk(S) 
segment, bikctl: Allocates data in a far . . . brkctl(S) 
search, bsearch: Performs a binary .... bsearch(S) 
a character to the console buffer, ungetch: Returns .... ungetch(DOS) 

output, fread, fwrite: Performs buffered binary input and .... fread(S) 

stdio: Performs standard buffered input and output stdio(S) 

setbuf, setvbuf: Assigns buffering to a stream setbuf(S) 

flushall: Flushes all output buffers flushall(DOS) 

idbuild: build new UNIX system kernel . . idbuild(ADM) 
kernel. link_unix: builds a new UNIX system .... link_unix(ADM) 

mknod: Builds special files mknod(C) 

database of alias and/ dbmbuild: builds the MMDF hashed .... dbmbuild(ADM) 

inp: Returns a byte inp(DOS) 

outp: Writes a byte to an output port outp(DOS) 

swab: Swaps bytes swab(S) 

movedata: Copies bytes from a specific address. . . movedata(DOS) 

cc: Invokes the C compiler. cc(CP) 

cflow: Generates C flow graj^ cflow(CP) 

epp: The C language preprocessor cpp(CP) 

lint: Checks C language usage and syntax. . . lint(CP) 

cxref: Generates C program cross-reference. . . . cxref(CP) 
cb: Beautifies C programs cb(CP) 
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xref: Cross-references C programs xref(CP) 

xstr: Extracts strings from C programs xstr(CP) 

an error message file from C source, mkstr: Creates .... mkstr(CP) 
distance, hypot, cabs: Determines Euclidean . . . hypot(S) 

cal: Prints a calendar. cal(C) 

values strmcfg: calculate STREAMS parameter . . strmcfg(ADM) 
blocks in a file, sum: Calculates checksum and counts . sum(C) 

Invokes an arbitrary precision calculator, dc: dc(C) 

be: Invokes a calculator. bc(C) 

cal: Prints a calendar. cal(C) 

service, calendar: Invokes a reminder . . . calendar(C) 

Data returned by stat system call, stat: stat(F) 

bdos: Invokes a DOS system call bdos(DOS) 

intdos: Invokes a DOS system call intdos(DOS) 

intdosx: Invokes a DOS system call intdosx(DOS) 

exit: Terminates the calling process exit(DOS) 

malloc, free, realloc, calloc: Allocates main memory. . . malloc(S) 

cu: Calls another XENIX system. . . cu(C) 

requests to lineprinter. Ip, cancel: Send/cancel lp(Q 

lineprinter. Ip cancel: Send/cancel requests to . . lp(C) 

termcap: Termini capability data base termcap(M) 

"terminfo: terminal" capability data base. . . 
description into a terminfo/ captoinfo: convert a termcap . . . captoinfo(ADM) 

pnch: file format for card images pnch(F) 

text editor (variant of ex for casual users) edit: edit(C) 

files, cat: Concatenates and displays . . cat(C) 

cb: Beautifies C programs cb(CP) 

cc: Invokes the C compiler. . . . cc(CP) 

cd: Changes working directory. . . cd(C) 

commentary of an SCCS delta, ede: Changes the delta cdc(CP) 

hs: High Sierra ISO-9660 CD-ROM filesystem hs(F) 

hs: High Sierra/ISO-9600 CD-ROM filesystem hs(F) 

value, floor,/ floor, fabs, ceil, fmod: Performs absolute . . . floor(S) 

/Performs absolute value, floor, ceiling and remainder functions. . floor(S) 

cflow: Generates C flow graph. . . cflow(CP) 

egets: Gets a string cgets(DOS) 

delta: Makes a delta (change) to an SCCS file delta(CP) 

allocation, sbrk, brk: Changes data segment space . . . sbrk(S) 

headers, fixhdr: Changes executable binary file . . fixhdr(C) 

chgrp: Changes group ID chgrp(Q 

chmod: Changes mode of a file chmod(S) 

environment, putenv: Changes or adds value to .... putenv(S) 

chown: Changes owner ID chown(C) 

nice: Changes priority of a process. . . nice(S) 

command, chroot: Changes root directory for .... chroot(ADM) 

modification dates of/ settime: Changes the access and settime(ADM) 

of a file or directory, chmod: Changes the access permissions . chmod(C) 
an SCCS delta, ede: Changes the delta commentary of . cdc(CP) 
file, newform: Changes the format of a text . . . newform(C) 
system fsname: Prints or changes the name of a file .... fsname(ADM) 
file, chown: Changes the owner and group of a . chown(S) 
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chnoot: Changes the root directory. . . . chroot(S) 

chsize: Changes the size of a file chsize(S) 

chdir: Changes the working directory. . . chdir(S) 

cd: Changes working directory. . . . cd(C) 

list: list processor channel for MMDF list(ADM) 

process NIC database into channel/domain tables nictable: . nictable(ADM) 

xtproto: multiplexed channels protocol used by/ .... xtproto(M) 

getch: Gets a character getch(DOS) 

getche: Gets and echoes a character getche(DOS) 

stream, ungetc: Pushes character back into input .... ungetc(S) 

isatty: Checks for a character device isatty(DOS) 

ioctl: Controls character devices ioctl(S) 

fgetc, fgetchar: Gets a character from a stream fgetc(DOS) 

getc, getchar, fgetc, getw: Gets character or word from a stream. . getc(S) 

/putchar, fputc, putw: Puts a character or word on a stream. . . putc(S) 

ascii: Map of the ASCII character set ascii(M) 

trchan: Translate character sets trchan(M) 

fputc, fjputchar: Write a character to a stream fputc(DOS) 

putch: Writes a character to the console putch(DOS) 

ungetch: Returns a character to the console buffer. . . ungetch(DOS) 

Displays/changes hard disk characteristics, dparam: dparam(ADM) 

Itoa: Converts long integers to characters ltoa(DOS) 

toascii: Classifies or converts characters, /tolower, toupper, . . ctype(S) 

tolower, toascii: Translates characters, conv, toupper, .... conv(S) 

tr: Translates characters tr(C) 

ultoa: Converts numbers to characters ultoa(DOS) 

wc: Counts lines, words and characters wc(Q 

strrev: Reverses the order of characters in a string strrev(DOS) 

charater. strset: Sets all characters in a string to one . . . strset(DOS) 

strlwr: Converts uppercase characters to lowercase strlwr(DOS) 

strupr: Converts lowercase characters to uppercase strupr(DOS) 

characters in a string to one charater. strset: Sets all strset(DOS) 

lastlogin, monacct,/ acctsh: chargefee, ckpacct, dodisk, . . . acctsh(ADM) 

directory, chdir: Changes the working . . . chdir(S) 

non-obviousness, goodpw: Check a password for goodpw(ADM) 

fstab: File system mount and check commands fstab(F) 

Authentication database authck: check internal consistency of . . . authck(ADM) 

permissions file uucheck: check the uucp directories and . . uucheck(ADM) 

tcbck: trusted computing base checker tcbck(ADM) 

processed by fsck. checklist: List of file systems . . . checklist(F) 

has been submitted but not/ checkmail: checks for mail which . checkmail(C) 

report generator checkque: MMDF queue status . . checkque(ADM) 
waitsem, nbwaitsem: Awaits and checks access to a resource/ , . . waitsem(S) 

fsck: Checks and repairs file systems. . fsck(ADM) 
syntax, lint: Checks C language usage and . . lint(CP) 

isatty: Checks for a character device. . . isatty(DOS) 

submitted but not/ checkmail: checks for mail which has been . . checkmail(C) 

grpcheck: Checks group file grpcheck(C) 

pwcheck: Checks password file pwcheck(C) 

keystroke, kbhit: Checks the console for a .... kbhit(DOS) 
to be read, rdchk: Checks to see if there is data . . . rdchk(S) 
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file, sum: Calculates checksum and counts blocks in a . sum(C) 

auditing for the next session chg_audit: enables and disable . . chg_audit(ADM) 

chgrp: Changes group ID chgrp(C) 

times: Gets process and child process times times(S) 

terminate, wait: Waits for a child process to stop or wait(S) 

chmod: Changes mode of a file. . . chmod(S) 

permissions of a file or/ chmod: Changes the access . . . chmod(C) 

chown: Changes owner ID. ... chown(C) 

group of a file, chown: Changes the owner and . . chown(S) 

for command, chroot: Changes root directory . . chroot(ADM) 

directory, chroot: Changes the root .... chroot(S) 
table chrtbl: create a ctype locale . . . chrtbl(M) 

file, chsize: Changes the size of a ... chsize(S) 
monacct,/ acetsh: chargefee, ckpacct, dodisk, lastlogin, .... acctsh(ADM) 
tolower, toupper, toascii: Qassifies or converts/ /isascii, . . ctype(S) 
in directories specified cleantmp: remove temporary files . cleantmp(ADM) 

uuclean: uucp spool directory clean-up uuclean(ADM) 

STREAMS error logger cleanup program strelean: .... strclean(ADM) 

clear: Clears a terminal screen. . . clear(C) 

stream status, ferror, feof, clearerr, fileno: Determines . . . ferror(S) 

clear: Clears a terminal screen clear(C) 

clri: Clears inode clri(ADM) 

a shell command interpreter with C-like syntax, esh: Invokes . . . csh(C) 

alarm: Sets a process’ alarm clock alarm(S) 

gets string from real-time clock getclk: getclk(M) 

system real-time (time of day) clock, clock: The clock(F) 

system real-time (time of day) clock, setclock: Sets the .... setclock(ADM) 

rtc: real time clock interface rtc(HW) 

clock: Reports CPU time used. . . clock(S) 

(time of day) clock, clock: The system real-time . . . clock(F) 

operations, closedir: Performs directory . . . directory(S) 

close: Closes a file descriptor close(S) 

fclose, fflush: Qoses or flushes a stream fclose(S) 

shuts down the/ haltsys, reboot: Closes out the file systems and . . haltsys(ADM) 

fclose, fcloseall: Closes streams fclose(DOS) 

clri: Clears inode clri(ADM) 

size, cmchk: Reports hard disk block . . cmchk(C) 

configuration data base, emos: Displays and sets the ... cmos(HW) 

emp: Compares two files cmp(C) 

coffconv: Convert 386 COFF files to XENIX format. . . coffconv(M) 

col: Filters reverse linefeeds. . . . col(C) 

coltbl: create a collation locale table coltbl(M) 

the audit/ auditd: read audit collection files generated by ... auditd(ADM) 

setcolor: Set screen color setcolor(C) 

screen: tty [0 1 -/i] , color, monochrome, ega, screen(HW) 

locale table coltbl: create a collation coltbl(M) 

Ic: Lists directory contents in columns lc(C) 

comb: Combines SCCS deltas. . . comb(CP) 

comb: Combines SCCS deltas comb(CP) 

common to two sorted files, comm: Selects or rejects lines . . comm(C) 

Changes root directory for command, chroot: chroot(ADM) 
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system: Executes a shell command. . systcm(S) 

time: Times a command timc(CP) 

language ksh: standard command and programming . . . ksh(C) 

language rksh: restricted command and programming . . . ksh(C) 

nice: Runs a command at a different priority. . . nice(C) 

segread: command description segread(DOS) 

env: Sets environment for command execution env(C) 

quits, nohup: Runs a command immune to hangups and . nohup(C) 

subsystem activationy auditcmd: command interface for audit . . . auditcmd(ADM) 

rsh: Invokes a restricted shell (command interpreter) rsh(C) 

sh: Invokes the shell command interpreter sh(C) 

syntax, csh: Invokes a shell command interpreter with C-like . csh(C) 
uux: Executes command on remote XENIX. . . . uux(C) 

getopt: Parses command options gctopt(C) 

getopts, getoptcvt - parse command options getopts: .... getopts(C) 
system activity timex: time a command; report process data and . timex(ADM) 
accounting records acctcms: command summary from per-process acctcms(ADM) 

File system mount and check commands, fstab: fstab(F) 

XENIX Development System commands, intro: Introduces . . . Intro(CP) 
and miscellaneous accounting commands /overview of accounting acct(ADM) 

help: Asks for help about SCCS commands help(CP) 

intro: Introduces XENIX commands Intro(C) 

xargs: Constructs and executes commands xargs(C) 

at, batch: Executes commands at a later time at(C) 

cron: Executes commands at specified times. . . . cron(C) 

micnet: The Micnet default commands file micnet(F) 

system, remote: Executes commands on a remote XENIX . . remote(C) 
environment rc2: run commands performed for multiuser rc2(ADM) 
operating system rcO: run commands performed to stop the . rcO(ADM) 
cdc: Changes the delta commentary of an SCCS delta. . . cdc(CP) 
line number entries in a common object file linenum: . . . linenum(F) 
relocation information for a common object file reloc: .... reloc(F) 

scnhdr. section header for a common object file scnhdr(F) 

routines Idfcn: common object file access .... ldfcn(F) 
format syms: common object file symbol table . syms(F) 

filehdr: file header for common object files filehdr(F) 

comm: Selects or rejects lines common to two sorted files. . . . comm(C) 

/the status of inter-process communication facilities ipcs(ADM) 

ftok: Standard interprocess communication package stdipc(S) 

cdrom: compact disk interface cdrom(HW) 

descriptions infocmp: compare or print out terminfo . . infocmp(ADM) 

dircmp: Compares directories dircmp(C) 

sdiffi Compares files side-by-side. . . . sdifi(C) 

diff. bdiff. Compares files too large for ... bdiff(C) 

diskcp, diskcmp: Copies or compares floppy disks diskcp(C) 

difi3: Compares three files difB(C) 

cmp: Compares two files cmp(C) 

diff. Compares two text files diff^C) 

file, sccsdiff Compares two versions of an SCCS sccsdiffi;CP) 

regexp: Regular expression compile and match routines. . . . regexp(S) 

"terminfo: Format of compiled terminfo file. 
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cc: Invokes the C compiler cc(CP) 

tic: Terminfo compiler tic(C) 

yacc: Invokes a compiler-compiler yacc(CP) 

expressions, regex, negcmp: Compiles and executes regular . . regex(S) 

regcmp: Compiles regular expressions. . . regcmp(CP) 

erf, erfc: Error function and complementary error function. . . erf(S) 

processes, wait: Awaits completion of background .... wait(C) 

subsystem: security subsystem component description subsystem(M) 

storage, compress: Compress data for ... compress(C) 

compress: Compress data for storage compress(C) 

pack, peat, unpack: Compresses and expands files. . . pack(C) 

scsi: Small computer systems interface. . . . scsi(HW) 

tebek: trusted computing base checker .... tcbck(ADM) 
cat: Concatenates and displays files. . . cat(C) 

conditions, test: Tests test(C) 

system, config: Configures a XENIX . . . config(ADM) 

for/ strmtune: STREAMS configuration interface strmtune(ADM) 

update, or get device driver configuration data /add, delete, . . idinstall(ADM) 

emos: Displays and sets the configuration data base cmos(HW) 

master EISA system kernel configuration file meisa(F) 

/line disciplines from kernel configuration files idaddld(ADM) 

hwconfig: Read the configuration information hwconfig(ADM) 

boards /UNIX kernel configuration manager for .... uconfig(ADM) 

strmcfg: STREAMS configuration utility strmcfg(ADM) 

upsconfig: UPS shutdown configuration utility upsconfig(ADM) 

peu: configure ports pcu(ADM) 

boards uconfig: configure kernel for new .... uconfig(ADM) 

Anapsem, mapstr, convkey: Configure monitor screen/ .... mapkey(M) 
mapehan: Configure tty device mapping. . . mapchan(M) 

config: Configures a XENIX system. . . . config(ADM) 

spooling system. Ipadmin: Configures the lineprinter .... Ipadmin(ADM) 
/fwtmp, wtmpfix: manipulate connect accounting records . . . fwtmp(ADM) 

an out-going terminal line connection, dial: Establishes . . . dial(S) 

database authek: check internal consistency of Authentication . . authck(ADM) 

eputs: Puts a string to the console cputs(DOS) 

putch: Writes a character to the console putch(DOS) 

to printer attached to a serial console /Print file consoleprint(ADM) 

Returns a character to the console buffer, ungetch: .... ungetch(DOS) 

console: System console device console(M) 

kbhit: Checks the console for a keystroke kbhit(DOS) 

cscanf: Converts and formats console input cscanf(DOS) 

messages: Description of system console messages messages(M) 

console: System console device. . console(M) 
printer attached to a serial/ consoleprint: Print file to .... consoleprint(ADM) 
for implementation-specific constants limits: file header . . . limits(F^ 

math: math functions and constants math(M) 

unistd: file header for symbolic constants unistd(F) 

mkfs: Constructs a file system mkfs(ADM) 

commands, xargs: Constructs and executes xargs(C) 

debugging on uutry:tryto contact remote system with . . . uutry(ADM) 

idmkinit: read files containing specifications .... idmkinit(ADM) 
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ev_Wock: Wait until the queue contains an event ev_block(S) 

Ic: Lists directory contents in columns lc(C) 

Is: Gives information about contents of directories ls(Q 

1: Lists information about contents of directory 1(C) 

Splits files according to context, csplit: csplit(C) 

uadmin: administrative control uadmin(ADM) 

uadmin: administrative control uadmin(S) 

UUCP status inquiry and job control, uustat: uustat(C) 

vc: version control vc(C) 

UUCP control files, uuinstall: Administers uuinstall(ADM) 
device tapecntl: AT&T tape control for QIC-24/QIC-02 tape . . tapecntl(C) 

init, inir: Process control initialization init(M) 

jagent: host control of windowing terminal . . jagent(M) 

msgctl: Provides message control operations msgctl(S) 

fcntl: file control options fcntl(M) 

cardjnfo: system tty controller card information file . . cardjnfo 

ioctl: Controls character devices. . . . ioctl(S) 

fcntl: Controls open files fcntl(S) 

semctl: Controls semaphore operations. . . semctl(S) 

operations, shmctl: Controls shared memory .... shmctl(S) 

Translates characters, conv, toupper, tolower, toascii: . . conv(S) 

fcvt, gcvt: Performs output conversions, ecvt, ecvt(S) 

format, cofifconv: Convert 386 COFF files to XENIX cofFcpnv(M) 

into a terminfo/ captoinfo: convert a termcap description . . captoinfo(ADM) 

double-precision/ strtod, atof: Converts a string to a strtod(S) 

UUCP routing/ uulist: converts a XENIX-style uulist(ADM) 

routing file to/ mnlist: converts a XENIX-style Micnet . . mnlist(ADM) 

dd: Converts and copies a file dd(C) 

input, cscanf: Converts and formats console . . cscanf(DOS) 

scanf, fscanf, sscanf: Converts and formats input. . . . scanf(S) 

libraries, ranlib: Converts archives to random . . . ranlib(CP) 

atof, atoi, atol: Converts ASCII to numbers. . . . atof(S) 

and long/ 13tol, ltol3: Converts between 3-byte integers . 13tol(S) 

and base 64 ASCII. a641,164a: Converts between long integer . . a641(S) 

toupper, toascii: Classifies or converts characters. /tolower, . . ctype(S) 

/gmtime, asctime, tzset: Converts date and time to ASCII. . ctime(S) 

characters. Itoa: Converts long integers to .... Itoa(DOS) 

uppercase, strupr: Converts lowercase characters to . strupr(DOS) 

ultoa: Converts numbers to characters. . ultoa(DOS) 
itoa: Converts numbers to integers. . . itoa(DOS) 

standard FORTRAN, ratfor: Converts Rational FORTRAN into ratfor(CP) 

strtol, atol, atoi: Converts string to integer strtol(S) 

units: Converts units units(C) 

lowercase, strlwr: Converts uppercase characters to . strlwr(DOS) 
file to MMDF/ mmdfalias: converts XENIX-style aliases . . mmdfalias(ADM) 

screen/ mapkey, mapscm, mapstr, convkey: Configure monitor . . . mapkey(M) 

dd: Converts and copies a file dd(C) 

address, movedata: Copies bytes from a specific . . . movedata(DOS) 

cpio: Copies file archives in and out. . . cpio(C) 

cp: Copies files cp(C) 

systems, rep: Copies files across XENIX .... rcp(C) 
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copy: Copies groups of files copy(C) 

diskcp, diskcmp: Copies or compares floppy disks. . diskcp(C) 

Public XENIX-to-XENIX file copy, uuto, uUpick: uuto(Q 

copy: Copies groups of files. . . . copy(C) 
volcopy : make literal copy of UNIX file system .... volcopy(ADM) 

for optimal access time dcopy: copy UNIX filesystems dcopy(ADM) 

core: Format of core image file. . . core(F) 

core: Format of core image file core(F) 

asktime: Prompts for the correct time of day asktime(ADM) 

atan2: Performs/ sin, cos, tan, asin, acos, atan, .... trig(S) 
functions, sinh, cosh, tanh: Performs hyperbolic . . sinh(S) 

sum: Calculates checksum and counts blocks in a file sum(C) 

characters, wc: Counts lines, words and wc(C) 

cp: Copies files. cp(C) 

cpio: Format of cpio archive cpio(F) 

and out. cpio: Copies file archives in ... cpio(C) 
cpio: Format of cpio archive. . . . cpio(F) 

preprocessor, cpp: The C language cpp(CP) 

cprintf: Formats output cprintf(DOS) 

Flushes block I/O and halts the CPU. shutdn: shutdn(S) 

clock: Reports CPU time used clock(S) 

console, cputs: Puts a string to the .... cputs(DOS) 

crash: examine system images . . crash(ADM) 
rewrites an existing one. creat: Creates a new file or .... creat(S) 

vdutil: create a virtual disk vdutil(ADM) 

coltbl: create a collation locale table . . . coltbl(M) 

chrtbl: create a ctype locale table .... chrtbl(M) 

curtbl: create a currency locale table . . . curtbl(M) 

mestbl: create a messages locale file ... mestbl(M) 

numtbl: Create a numeric locale table. . . numtbl(M) 

file. tmpnam,tempnam: Creates a name for a temporary . . tmpnam(S) 

mkdir: Creates a new directory mkdir(DOS) 

an existing one. creat: Creates a new file or rewrites . . . creat(S) 

folk: Creates a new process fork(S) 

spawnl, spawnvp: Creates a new process spawn(DOS) 

ctags: Creates a tags file ctags(CP) 

tee: Creates a tee in a pipe tee(C) 

tmpfile: Creates a temporary file tmpfile(S) 

from C source, mkstr: Creates an error message file ... mkstr(CP) 

profile, profil: Creates an execution time .... profil(S) 

semaphore, creatsem: Creates an instance of a binary . . creatsem(S) 

pipe: Creates an interprocess pipe. . . . pipe(S) 

files, admin: Creates and administers SCCS . . admin(CP) 

/Scans fixed disk for flaws and creates bad track table badtrk(ADM) 

umask: Sets and gets file creation mask umask(S) 

a binary semaphore, creatsem: Creates an instance of . creatsem(S) 
listing, cref: Makes a cross-reference . . cref(CP) 

atcronsh: Menu driven at and cron administration utility .... atcronsh(ADM) 
specified times, cron: Executes commands at . . . cron(C) 

"crontab: user" "crontab file" 

"crontab: user crontab 
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intro: Introduction to DOS 
dosld: XENIX to MS-DOS 
cxref: Generates C program 
cref: Makes a 
xref: 

console input, 
interpreter with C-like syntax. 

to context, 
terminal 

for a terminal, 
asctime, tzset: Converts date/ 
islower, isdigit, isxdigity 
chrtbl: create a 

curtbl: create a 
ev_getemask: Return the 
rename login entry to show 
pointer, tell: Gets the 
activity, sact: Prints 
the slot in the utmp file of the 
getcwd: Get the pathname of 
uname: Gets name of 
uname: Prints the name of the 
/Returns the number of events 
ev_flush: Discard all events 
/displays the list of vectors 
/the list of major device numbers 
cursor functions. 
scr_dump: format of 
curses: Performs screen and 
table 

spline: Interpolates smooth 
the user, 
each line of a file, 
line of a file, cut: 
cross-reference. 
STREAMS error logger 
daemon.mn: Micnet mailer 
vddaemon: virtual disk 

runacct: run 
- handle special functions of 
handle special functions of the 
get device driver configuration 
prof: Displays profile 
sdwaitv: Synchronizes shared 
reduce: perform audit 
time a command; report process 
and sets the configuration 



cross development functions, 
cross linker. 



cross-reference listing 

Cross-references C programs. 

crypt: encode/decode 

cscanf: Converts and formats . . 
csh: Invokes a shell command 
csplit: Splits files according . . 
ct: spawn getty to a remote . . 
ctags: Creates a tags file. . . . 
ctermid: Generates a filename 
ctime, localtime, gmtime, . . . 
ctype, isalpha, isupper, .... 

ctype locale table 

cu: Calls another XENIX system. 

currency locale table 

current event mask 

current layer relogin: 

current position of the file ... 

current SCCS file editing . . . 
current user, ttyslot: Finds . . . 
current working directory. . . . 

current XENIX system 

current XENIX system 

currently in the queue 

currently in the queue 

currently specified in the/ . . . 

currently specified in the/ . . . 

curses: Performs screen and . . 

curses screen image file 

cursor functions 

curtbl: create a currency locale 

curve 

cuserid: Gets the login name of . 
cut: Cuts out selected fields of 
Cuts out selected fields of each . 
cxref: Generates C program . . 

daemon strerr: 

daemon 

daemon 

daemon.mn: Micnet mailer daemon. 

daily accounting 

DASI 300 and 300s/ /300s . . . 
DASI 450 terminal 450: .... 
data /add, delete, update, or . . 

data 

data access, sdgetv, 

data analysis and reduction . . 
data and system activity timex: . 
data base, cmos: Displays . . . 



cross-reference. 



intro(DOS) 

dosld(CP) 

cxref(CP) 

cref(CP) 

xref(CP) 

crypt(C) 

cscanf(DOS) 

csh(C) 

csplit(C) 

ct(C) 

ctags(CP) 

ctermid(S) 

ctime(S) 

ctype(S) 

chrtbl(M) 

cu(C) 

curtbl(M) 

ev_gtemsk(S) 

relogin(ADM) 

tell(DOS) 

sact(CP) 

ttyslot(S) 

getcwd(S) 

uname(S) 

uname(C) 

ev_count(S) 

ev_fiush(S) 

vectorsinuse(ADM) 

majorsinuse(ADM) 

curses(S) 

scr_dump(F) 

curses(S) 

curtbl(M) 

spline(CP) 

cuserid(S) 

cut(C) 

cut(C) 

cxref(CP) 

strerr(ADM) 

daemon.mn(M) 

vddaemon(ADM) 

daemon.mn(M) 

runacct(ADM) 

300(C) 

450(C) 

idinstall(ADM) 

prof(CP) 

sdgetv(S) 

reduce(ADM) 

timex(ADM) 

cmos(HW) 
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termcap: Terminal capability data base termcap(M) 

"terminfo: terminal capability" database. 

generate disk accounting data by user ID diskusg: .... diskusg(ADM) 

compress: Compress data for storage compress(C) 

brkctl: Allocates data in a far segment brkctl(S) 

/sgetl: Accesses long integer data in a machine-independent. . . sputl(S) 

plock: Lock process, text, or data in memory plock(S) 

execseg: makes a data region executable execseg(S) 

call, stat: Data returned by stat system . . . stat(F) 

Attaches and detaches a shared data segment, sdget, sdfiee: . . . sdget(S) 

Synchronizes access to a shared data segment, sdenter, sdleave: . . sdenter(S) 

sbrk, brk: Changes data segment space allocation. . . sbik(S) 

rdchk: Checks to see if there is data to be read rdchk(S) 

types: Primitive system datatypes types(F) 

authcap: authentication database authcap(ADM) 

consistency of Authentication database authck: check internal . authck(ADM) 

files against authentication database /examine system .... integrity(ADM) 

"teiminfo: terminal description" database. 

tput: Queries the terminfo database tput(C) 

isverify: verifies ISAM database entries isverify(M) 

backups schedule: Database for automated system . . schedule(ADM) 

firstkey, nextkey: Performs database functions, /delete, . . . dbm(S) 

tables nictable: process NIC database into channel/domain . . nictable(ADM) 

/builds the MMDF hashed database of alias and routing/ . . . dbmbuild(ADM) 

date: Prints and sets the date date(C) 

time, ftime: Gets time and date time(S) 

/gmtime, asctime, tzset: Converts date and time to ASCII ctime(S) 

date: Prints and sets the date. . . . date(C) 

sddate: Prints and sets backup dates sddate(C) 

the access and modification dates of files. /Changes settime(ADM) 

strftime: format date/time string strftime(S) 

Prompts for the correct time of day. asktime: asktime(ADM) 

The system real-time (time of day) clock, clock: clock(F) 

the system real-time (time of day) clock, setclock: Sets .... setclock(ADM) 

MMDF hashed database of/ dbmbuild: builds the dbmbuild(ADM) 

firstkey, nextkey: Performs/ dbminit, fetch, store, delete, . . . dbm(S) 

precision calculator, dc: Invokes an arbitrary dc(C) 

filesystems for optimal access/ dcopy: copy UNIX dcopy(ADM) 

dd: Converts and copies a file. . . dd(C) 
devices, assign, deassign: Assigns and deassigns . assign(C) 

assign, deassign: Assigns and deassigns devices assign(C) 

adb: Invokes a general-purpose debugger. adb(CP) 

fsdb: File system debugger fsdb(ADM) 

sdb: Invokes symbolic debugger sdb(CP) 

to contact remote system with debugging on uutry: try uutry(ADM) 

transmission via mail uudecode: decode a binary file for uuencode(C) 

fdswap: Swaps default boot floppy drive fdswap(ADM) 

micnet: The Micnet default commands file micnet(F) 

information directory, default: Default program .... default(F) 

defopen, defread: Reads default entries defopen(S) 

directory, default: Default program information . . . default(F) 
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timezone: set default system time zone .... timezone(F) 
entries, defopen, defiead: Reads default . . defopen(S) 
defopen, defiead: Reads default entries. . . defopen(S) 

del.vd: delete a virtual disk del.vd(ADM) 

Performs/ dbminit, fetch, store, delete, firstkey, nextkey: .... dbm(S) 

driver/ idinstall: add, delete, update, or get device . . . idinstall(ADM) 

imdir: Deletes a directory rmdir(DOS) 

process deliver: MMDF mail delivery . . deliver(ADM) 

which has been submitted but not delivered /checks for mail .... checkmail(C) 
pathname, dimame: Delivers directory part of .... dimame(C) 
file, tail: Delivers the last part of a .... tail(C) 
maildelivery: user mail delivery specification file .... maildelivery(F) 

deliver: MMDF mail delivery process deliver(ADM) 

the delta commentary of an sees delta. cdc:C!hanges cdc(eP) 

delta: Makes a delta (change) to an SCCS file. . . delta(eP) 
delta, ede: ehanges the delta commentary of an SCCS . . cdc(eP) 

rmdel: Removes a delta from an SeeS file rmdel(eP) 

an sees file, delta: Makes a delta (change) to . delta(eP) 

comb: eombines SeeS deltas comb(eP) 

terminal, mesg: Permits or denies messages sent to a .... mesg(e) 
description into a terminfo description /convert a termcap . . captoinfo(ADM) 

security subsystem component description subsystem: subsystem(M) 

segread: command description segread(DOS) 

•'terminfo: terminal" description database. . . 
captoinfo: convert a termcap description into a terminfo/ . . . captoinfo(ADM) 

Machine: Description of host machine. . . . machine(HW) 

messages, messages: Description of system console . . messages(M) 

compare or print out terminfo descriptions infoemp: infocmp(ADM) 

close: Closes a file descriptor close(S) 

dup2: Duplicates an open file descriptor, dup, dup(S) 

sdget, sdfree: Attaches and detaches a shared data segment. . sdget(S) 

fstyp: determine file system identifier . . fstyp(ADM) 

file, access: Determines accessibility of a ... access(S) 

dtype: Determines disk type dtype(C) 

eof: Determines end-of-file eof(DOS) 

hypot, cabs: Determines Euclidean distance. . . hypot(S) 

file: Determines file type file(C) 

ferror, feof, clearerr, fileno: Determines stream status ferror(S) 

whodo: Determines who is doing what. . . whodo(C) 

audit: audit subsystem interface device audit(ADM) 

console: System console device console(M) 

control for QIC-24/QIC-02 tape device tapecntl: AT&T tape . . . tapecntl(C) 

error: Kernel error output device error(M) 

font and video mode for a video device, vidi: Sets the vidi(C) 

isatty: Checks for a character device isatty(DOS) 

systty: System maintenance device systty(M) 

/add, delete, update, or get device driver configuration data . . idinstall(ADM) 

/Default backup device information archive(F) 

scsinfo: display current SCSI device information scsinfo(ADM) 

Ip, IpO, Ipl, lp2: Line printer device interfaces Ip(HW) 

mapehan: Configure tty device mapping mapchan(M) 
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mapchan: Format of tty device mapping files mapchan(F) 

devnm: Identifies device name devnm(C) 

/displaying and removing hard disk device names hdutil(ADM) 

current SCSI hard disks /display device names (letters) for .... scsinfo(ADM) 
/displays the list of major device numbers currently/ . . majorsinuse(ADM) 
disks /display major and minor device numbers for current SCSI . scsinfo(ADM) 

dcassign: Assigns and deassigns devices, assign, assign(C) 

event queue and all associated devices. ev_close: Close the . . . ev_close(S) 

ioctl: Controls character devices ioctl(S) 

ev_getdev: Gets a list of devices feeding an event queue. . ev_getdev(S) 

devices: Format of UUCP devices file. devices(F) 

ev_gindev: include/exclude devices for event input ev_gindev(S) 

file, devices: Format of UUCP devices . devices(F) 

devnm: Identifies device name. . . devnm (C) 
blocks, df: Report number of free disk . . df(C) 

dial: Dials a modem dial(ADM) 

terminal line connection, dial: Establishes an out-going . . dial(S) 

dialcodes: Format of UUCP dial-code abbreviations file. . . . dialcodes(F) 

dial-code abbreviations file, dialcodes: Format of UUCP . . . dialcodes(F) 

dialers: Format of UUCP Dialers file dialers(F) 

file, dialers: Format of UUCP Dialers . dialers(F) 

dial: Dials a modem dial(ADM) 

uuchat: dials a modem dial(ADM) 

passwd: Change login, group, or dialup shell password passwd(C) 

Compares files too large for diff. bdiff. bdifB^C) 

diff. Compares two text files. . . . diff(C) 

difB: Compares three files. . . . difl3(C) 

dir: Format of a directory dir(F) 

diremp: Compares directories. . . dircmp(C) 

diremp: Compares directories dircmp(C) 

information about contents of directories. Is: Gives ls(C) 

link and unlink files and directories link: link, unlink: . . . link(ADM) 

mv: Moves or renames files and directories mv(C) 

rm, rmdir: Removes files or directories rm(C) 

rmdir: Removes directories rmdir(C) 

uucheck: check the uucp directories and permissions file . . uucheck(ADM) 

remove temporary files in directories specified cleantmp: . . cleantmp(ADM) 

Default program information directory, default: default(F) 

access permissions of a file or directory, chmod: Changes the . . chmod(C) 

cd: Changes working directory cd(C) 

chdir: Changes the working directory chdir(S) 

chroot: Changes the root directory chroot(S) 

dir: Format of a directory dir(F) 

information about contents of directory. 1: Lists 1(C) 

mkdir: Creates a new directory mkdir(DOS) 

mkdir: Makes a directory mkdir(C) 

mvdir: Moves a directory mvdir(C) 

rename: renames a file or directory rename(DOS) 

rmdir: Deletes a directory rmdir(DOS) 

the pathname of current working directory, getewd: Get getcwd(S) 

uuclean: uucp spool directory clean-up uuclean(ADM) 
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Ic: Lists directory contents in columns. . . lc(C) 

file, getdents: read directory entries and put in a ... getdents(S) 

dirent: file system independent directory entry dirent(F) 

dirent: file-system-independent directory entry dirent(F) 

unlink: Removes directory entry unlink(S) 

chroot: Changes root directory for command chroot(ADM) 

uucico: Scan the spool directory for woik uucico(C) 

pwd: Prints woiking directory name. . pwd(C) 

basename: Removes directory names from pathnames. . basenamc(C) 

closedir: Performs directory operations directory(S) 

ordinary file, mknod: Makes a directory, or a special or mknod(S) 

dimame: Delivers directory part of pathname. . . . dimame(C) 

directory entry, dirent: file system independent . . dirent(F) 

directory entry dirent: file-system-independent . . dirent(F) 

of pathname, dimame: Delivers directory part . dimame(C) 
session chg_audit: enables and disable auditing for the next . . . chg_audit(ADM) 

printers, disable: T\ims off terminals and . . disable(C) 
acct: Enables or disables process accounting. . . . acct(S) 

the queue. ev_flush: Discard all events currently in . . ev_flush(S) 

type, modes, speed, and line discipline /set terminal uugetty(ADM) 

type, modes, speed, and line discipline. /Sets terminal .... getty(M) 

add.vd: add a virtual disk add.vd(ADM) 

cdrom: compact disk interface cdrom(HW) 

vdinfo: display virtual disk information vdinfo(ADM) 

diskusg: generate disk accounting data by user ID . . diskusg(ADM) 

cmchk: Reports hard disk block size. . cmchk(C) 

df: Report number of free disk blocks df(C) 

dparam: Displays/changes hard disk characteristics dparam(ADM) 

/displaying and removing hard disk device names hdutil(ADM) 

hd: Internal hard diskdrive hd(HW) 

track/ badtrk: Scans fixed disk for flaws and creates bad . . badtrk(ADM) 

vddaemon: virtual disk initialization vddaemon(ADM) 

and size/ display hard disk partition, division, dlayout(ADM) 

fdisk: Maintain disk partitions fdisk(ADM) 

dtype: Determines disk type dtype(C) 

du: Summarizes disk usage du(C) 

and removing/ hdutil: hard disk utility for displaying .... hdutil(ADM) 
floppy disks, diskcp, diskcmp: Copies or compares . . diskcp(C) 
compares floppy disks, diskcp, diskcmp: Copies or ... diskcp(C) 

Copies or compares floppy disks, diskcp, diskcmp: diskcp(C) 

format: fomiat floppy disks format(C) 

accounting data by user ID diskusg: generate disk diskusg(ADM) 

umount: Dismounts a file stmcture umount(ADM) 

major/minor numbers display specific hard disk .... hdutil(ADM) 

zcat: Display a stored file compress(C) 

for a mirrored disk vdutil: display bad blocks vdutil(ADM) 

information scsinfo: display current SCSI device . . . scsinfo(ADM) 

vedit: Invokes a screen-oriented display editor, vi, view, vi(C) 

division, and size/ display hard disk partition, .... dlayout(ADM) 

displaypkg: display installed packages .... displaypkg(ADM) 
vdinfo: display virtual disk information . vdinfo(ADM) 
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specific hard disk names/ displaying and removing .... hdutil(ADM) 

packages displaypkg: display installed . . . displaypkg(ADM) 

configuration data base, cmos: Displays and sets the cmos(HW) 

cat: Concatenates and displays files cat(C) 

format, hd: Displays files in hexadecimal . . . hd(C) 

od: Displays files in octal format. . . . od(C) 

system activity, uptime: Displays information about . . . uptime(C) 

is on the system and what w: Displays information about who . w(C) 

prof: Displays profile data prof(CP) 

executable binary files, hdr: Displays selected parts of .... hdr(CP) 
device numbers/ majorsinuse: displays the list of major .... majorsinuse(ADM) 
currently/ vectorsinuse: displays the list of vectors .... vectorsinuse(ADM) 
characteristics, dparam: Displays/changes hard disk . . . dparam(ADM) 

mail: Sends, reads or disposes of mail mail(C) 

cabs: Determines Euclidean distance, hypot, hypot(S) 

lcong48: Generates uniformly distributed. srand48, seed48, . . . drand48(S) 

disk partition, division, and size information . . dlayout(ADM) 
divvy -b block_device -c c/ . . divvy(ADM) 
records for subsystem events dlvr_audit: produce audit .... dlvr_audit( ADM) 

object downloader for the 5620 DMD terminal wtinit: wtinit(ADM) 

acctsh: chargefee, ckpacct, dodisk, lastlogin, monacct,/ . . . acctsh(ADM) 

whodo: Determines who is doing what whodo(C) 

promain: restrict the execution domain of a program promain(M) 

intro: Introduction to DOS cross development functions. intro(DOS) 

dosexterr: Gets DOS error messages dosexter(DOS) 

dosls, dosrm, dosrmdir: Access DOS files dos(C) 

bdos: Invokes a DOS system caU bdos(DOS) 

intdos: Invokes a DOS system call intdos(DOS) 

intdosx: Invokes a DOS system call intdosx(DOS) 

messages, dosexterr: Gets DOS error .... dosexter(DOS) 

linker, dosld: XENIX to MS-DOS cross . dosld(CP) 

DOS files, dosls, dosrm, dosrmdir: Access . . dos(C) 

files, dosls, dosrm, dosrmdir: Access DOS . . dos(C) 

dosls, dosrm, dosrmdir: Access DOS files. . . . dos(C) 

/atof: Converts a string to a double-precision number strtod(S) 

DMD/ wtinit: object downloader for the 5620 .... wtinit(ADM) 

disk characteristics, dparam: Displays/changes hard . . dparam(ADM) 

graph: draw a graph graph(ADM) 

Swaps default boot floppy drive, fdswap: fdswap(ADM) 

hd: Internal hard disk drive hdCH’^ 

administration/ atcronsh: Menu driven at and cron atcronsh(ADM) 

utility auditsh: Menu driven audit administration . . . auditsh(ADM) 

utility backupsh: Menu driven backup administration . . . backupsh(ADM) 

administration/ Ipsh: Menu driven Ip print service Ipsh(ADM) 

utility, sysadmsh: Menu driven system administration . . . sysadmsh(ADM) 

protocol used by x t (7) driver Anultiplexed channels . . . xtproto(M) 

sxt: Pseudo-device driver sxt(M) 

delete, update, or get device driver configuration data /add, . . idinstall(ADM) 

object module, routines: finds driver entry points in a driver . . . routines(ADM) 

terminals xt: multiplexed tty driver for AT&T windowing . . . xt(HW) 

finds driver entry points in a driver object module, routines: . . routines(ADM) 
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xtt: extract and print xt driver packet traces xtt( ADM) 

xts: extract and print xt driver statistics xts(ADM) 

term: Terminal driving tables for nroffi term(F) 

dtype: Determines disk type. . . . dtype(C) 

du: Summarizes disk usage. . . . du(C) 

backup: Incremental dump tape format backup(F) 

files on a backup archive, dumpdir: Prints the names of . . . dumpdir(C) 

file, tapedump: IXunps magnetic tape to output . . tapedump(C) 

file descriptor, dup, dup2: Ehiplicates an open . . dup(S) 

descriptor, dup, dup2: Duplicates an open file ... dup(S) 

descriptor, dup, dup2: Duplicates an open file dup(S) 

echo: Echoes arguments echo(Q 

getche: Gets and echoes a character getche(DOS) 

echo: Echoes arguments echo(C) 

output conversions, ecvt, fcvt, gcvt: Performs .... ecvt(S) 

ed: Invokes the text editor. .... ed(C) 

program, end, etext, edata: Last locations in end(S) 

for casual users) edit: text editor (variant of ex ... edit(C) 

sact: Prints current SCCS file editing activity sact(CP) 

a screen-oriented display editor. Aiew, vedit: Invokes . . . vi(C) 

ed: Invokes the text editor ed(C) 

ex: Invokes a text editor ex(C) 

Id: Invokes the link editor Id(CP) 

Id: Invokes the link editor ld(M) 

Format of assembler and link editor output. a.out: a.out(F) 

the stream editor, sed: Invokes sed(C) 

users) edit: text editor (variant of ex for casual . . edit(C) 

effective user, real group, and effective group IDs. Aeal user, . . getuid(S) 

/getgid, getegid: Gets real user, effective user, real group, and/ . . getuid(S) 

color, monochrome, ega,. /tty[01-«], screen(HW) 

for a pattern, grep, egrep, fgrep: Searches a file ... grep(C) 

filemeisa: master EISA system kernel configuration . meisa(F) 

i286emul: emulate 80286 i286emul(C) 

x286emul: emulate XENIX 80286 x286emul(C) 

line printers, enable: Thms on terminals and . . enable(C) 

the next session chg_audit: enables and disable auditing for . . chg_audit(ADM) 

accounting, acct: Enables or disables process . . . acct(S) 

transmission via mail uuencode: encode a binary file for uuencode(C) 

crypt: encode/decode crypt(C) 

makekey: Generates an encryption key makekey(M) 

locations in program, end, etext, edata: Last end(S) 

/getgrgid, getgmam, setgrent, endgrent: Get group file entry. . . getgrent(S) 

eof: Determines end-of-file eof(DOS) 

/getpwuid, getpwnam, setpwent, endpwent: Gets password file/ . . getpwent(S) 

utmp file entry, endutent, utmpname: Accesses . . getut(S) 

submit: MMDF mail enqueuer submit(ADM) 

defopen, defread: Reads default entries defopen(S) 

wtmp: Formats of utmp and wtmp entries, utmp, utmp(F) 

getdents: read directory entries and put in a file getdents(S) 

xlist, fxlist: Gets name list entries from files xlist(S) 

nlist: Gets entries from name list nlist(S) 
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linenum; line number entries in a common object file . . linenum(F) 
directory entry /file-system-independent . . dirent(F) 

cndgrent: Get group file entry, /getgmam, setgrent, .... getgrent(S) 
cndpwent: Gets password file entry, /getpwnam, setpwent, . . . getpwent(S) 

pulpwcnt: Writes a password file entry putpwent(S) 

system independent directory entry, dirent: file dirent(F) 

unlink: Removes directory entry unlink(S) 

utmpname: Accesses utmp file entry, endutent getut(S) 

module, routines: finds driver entry points in a driver object . . routines(ADM) 
relogin: rename login entry to show current layer .... nelogin(ADM) 
command execution, env: Sets environment for .... env(C) 

environ: The user environment. . . environ(M) 

Set or read international environment setlocale: setlocale(S) 

commands performed for multiuser environment rc2: run rc2(ADM) 

environ: The user environment environ(M) 

putenv: Changes or adds value to environment putenv(S) 

profile: Sets up an environment at login time profile(M) 

execution, env: Sets environment for command .... env(C) 

getenv: Gets value for environment name getenv(S) 

TZ: Time zone environment variable tz(M) 

eof: Determines end-of-file. . . . eof(DOS) 

complementary error function, erf, erfc: Error function and . . . erf(S) 

complementary error/ erf, erfc: Error function and erf(S) 

perror, sys_errlist, sys_nerr, ermo: Sends system error/ .... perror(S) 

Error function and complementary error function, erf, erfc: erf(S) 

error function, erf, erfc: Error function and complementary erf(S) 

device, error: Kernel error output .... error(M) 
strelean: STREAMS errorlogger cleanup program . . . strclean(ADM) 

strerr: STREAMS error logger daemon strerr(ADM) 

source, mkstr: Creates an error message file from C .... mkstr(CP) 

dosexterr: Gets DOS error messages dosexter(DOS) 

sys_nerr, ermo: Sends system error messages. /sys_errlist, . . . perror(S) 

services, library routines and error numbers, /system Intro(S) 

error: Kernel error output device error(M) 

fsave: Interactive, error-checking filesystem backup . fsave(ADM) 

matherr: Error-handling function matherr(S) 

hashcheck: Finds spelling errors, /hashmake, spellin, .... spell(C) 
terminal line connection, dial: Establishes an out-going .... dial(S) 

setmnt: Establishes /etc/mnttab table. . . . setmnt(ADM) 

setmnt: Establishes /etc/mnttab table setmnt(ADM) 

program, end, etext, edata: Last locations in . . . end(S) 

hypot, cabs: Determines Euclidean distance hypot(S) 

expression, expr: Evaluates arguments as an .... expr(C) 
contains an event. ev_block: Wait until the queue . . ev_block(S) 
and all associated devices. ev_close: Close the event queue . ev_close(S) 
events currently in the queue. ev_count: Returns the number of . ev_count(S) 

Wait until the queue contains an event. ev_block: ev_block(S) 

ev_read: Read the next event in the queue ev_read(S) 

include/exclude devices for event input. ev_gindev: ev_gindev(S) 

evjnit: Invokes the event manager ev_init(S) 

ev_getemask: Return the current event mask ev_gtemsk(S) 
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ev_setemask: Sets event mask ev_stemsk(S) 

ev_pop: Pop the next event off the queue ev_pop(S) 

a list of devices feeding an event queue. ev_getdev: Gets . . ev_getdcv(S) 

ev_suspend: Suspends an event queue. ev_susp(S) 

devices. ev_close; Close the event queue and all associated . . ev_close(S) 

ev_open: Opens an event queue for input ev_open(S) 

audit records for subsystem events dlvr_audit: produce . . . dlvr_audit(ADM) 

ev_count; Returns the number of events currently in the queue. . . ev_count(S) 

ev_flush; Discard all events currently in the queue. . . ev_flush(S) 

currently in the queue. ev_flush: Discard all events . . . ev_flush(S) 

devices feeding an event queue. ev_getdev: Gets a list of ev_getdev(S) 

event mask. ev_getemask: Return the current . ev__gtemsk(S) 
devices for event input. ev_^indev: include/exclude . . . ev_gindev(S) 

manager, evjnit: Invokes the event .... ev_init(S) 
for input. ev_open: Opens an event queue . . ev_open(S) 

the queue. ev_pop: Pop the next event off . . ev_pop(S) 

the queue. ev_read: Read the next event in . . ev_read(S) 

queue. ev_resume: Restart a suspended . ev_resume(S) 
ev_setemask: Sets event mask. . . ev_stemsk(S) 

queue. ev_suspend: Suspends an event , . ev_susp(S) 

edit: text editor (variant of ex for casual users) edit(C) 

ex: Invokes a text editor ex(C) 

authentication/ integrity: examine system files against . . . integrity(ADM) 

crash: examine system images crash(ADM) 

pax: portable archive exchange pax(C) 

execlp, execvp: Executes a/ execl, execv, execle, execve, . . . exec(S) 

Executes a file, execl, execv, execle, execve, execlp, execvp: . . exec(S) 

execl, execv, execle, execve, execlp, execvp: Executes a file. . . exec(S) 

executable, execseg: makes a data region . . . execseg(S) 

execseg: makes a data region executable execseg(S) 

fixhdr: Changes executable binary file headers. . . fixhdr(C) 

hdr: Displays selected parts of executable binary files hdr(CP) 

execle, execve, execlp, execvp: Executes a file, execl, execv, . . exec(S) 

system: Executes a shell command. . . . system(S) 

int86: Executes an interrupt int86(DOS) 

int86x: Executes an interrupt int86x(DOS) 

XENIX, uux: Executes command on remote . . uux(C) 

xargs: Constructs and executes commands xargs(C) 

time, at, batch: Executes commands at a later . . at(C) 

times, cron: Executes commands at specified . cron(C) 

XENIX system, remote: Executes commands on a remote . remote(C) 

regex, regcmp: Compiles and executes regular expressions. . . . regex(S) 

Sets environment for command execution, env: env(C) 

promain: restrict the execution domain of a program . . promain(M) 

nap: Suspends execution for a short interval. . . nap(S) 

sleep: Suspends execution for an interval sleep(C) 

sleep: Suspends execution for an interval sleep(S) 

monitor: Prepares execution profile monitor(S) 

profil: Creates an execution time profile profil(S) 

execvp: Executes a file, execl, execv, execle, execve, execlp, . . exec(S) 

a file, execl, execv, execle, execve, execlp, execvp: Executes . exec(S) 
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execv, execle, execve, execlp, execvp: Executes a file, execl, . . exec(S) 

link: Links a new filename to an existing file link(S) 

a new file or rewrites an existing one. creat: Creates . . . creat(S) 

process, exit, _exit: Terminates a exit(S) 

exit, _exit: Terminates a process. . . . exit(S) 

process, exit: Terminates the calling . . . exit(DOS) 

false: Returns with a nonzero exit value false(C) 

true: Returns with a zero exit value true(C) 

Performs exponential,/ exp, log, pow, sqrt, loglO: .... exp(S) 

peat, unpack: Compresses and expands files, pack, pack(C) 

number into a mantissa and an exponent. /Splits floating-point . . frexp(S) 

/log, pow, sqrt, log 10: Performs exponential, logarithm, powers . . exp(S) 

expression, expr: Evaluates arguments as an . expr(C) 

expr: Evaluates arguments as an expression expr(C) 

routines, regexp: Regular expression compile and match . . regexp(S) 

Compiles and executes regular expressions, regex, regemp: . . . regex(S) 

regemp: Compiles regular expressions regcmp(CP) 

rmb: remove extra blank lines from a file ... rmb(M) 
packet traces xtt: extract and print xt driver .... xtt(ADM) 
statistics xts: extract and print xt driver .... xts(ADM) 

programs, xstr: Extracts strings from C xstr(CP) 

absolute value, floor,/ floor, fabs, ceil, fmod: Performs .... floor(S) 
of inter-process communication facilities. /Reports the status . . . ipcs(ADM) 

factor: Factor a number factor(C) 

factor: Factor a number factor(C) 

powerfail: performs power failure shutdown service .... powerfail(M) 

restart: performs power failure recovery service restart(M) 

exit value, false: Returns with a nonzero . . . false(C) 

abort: Generates an lOT fault abort(S) 

currently specified in the s d e v i c e file /of vectors . vectorsinuse(ADM) 

streams, fclose, fcloseall: Closes fclose(DOS) 

flushes a stream, fclose, fflush: Closes or fclose(S) 

fclose, fcloseall: Closes streams fclose(DOS) 

fcntl: Controls open files fcntl(S) 

fcntl: file control options .... fcntl(M) 
conversions, ecvt, fevt, gevt: Performs output .... ecvt(S) 

fdisk: Maintain disk partitions. . . fdisk(ADM) 

fopen, freopen, fdopen: Opens a stream fopen(S) 

floppy drive, fdswap: Swaps default boot . . . fdswap(ADM) 

/to machine related miscellaneous features and files Intro(HW) 

Introduction to miscellaneous features and files, intro: Intro(M) 

/Gets a list of devices feeding an event queue ev_getdev(S) 

Determines stream/ ferror, feof, clearerr, fileno: ferror(S) 

Determines stream status, ferror, feof, clearerr, fileno: . . . ferror(S) 

nextkey: Performs/ dbminit, fetch, store, delete, firstkey, . . . dbm(S) 

stream, fclose, fiflush: Closes or flushes a .... fclose(S) 

character from a stream, fgetc, fgetchar: Gets a fgetc(DOS) 

word from a/ getc, getchar, fgetc, getw: Gets character or . . getc(S) 

a stream, fgetc, fgetchar: Gets a character from . . fgetc(DOS) 
stream, gets, fgets: Gets a string from a .... gets(S) 
pattern, grep, egrep, fgrep: Searches a file for a .... grep(C) 
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cut: Cuts out selected fields of each line of a file cut(C) 

Alternative login terminals file, inittab: inittab(F) 

Changes the format of a text file, newform: newform(C) 

Changes the owner and group of a file, chown: chown(S) 

Compares two versions of an sees file, scesdifif. sccsdifi(CP) 

Creates a name for a temporary file, tmpnam, tempnam: tmpnam(S) 

Delivers the last part of a file, tail: tail(C) 

Determines accessibility of a file, access: access(S) 

Dumps magnetic tape to output file, tapedump: tapedump(C) 

Format of UUCP Permissions file, permissions: permissions(F) 

Format of UUCP Sysfiles file, sysfiles: sysfiles(F) 

Format of compiled terminfo file, "terminfo:" terminfo(F) 

Format of per-process accounting file, acet: acct(F) 

Prints the size of an object file, size: size(CP) 

Removes a delta from an SCCS file, rmdel: rmdel(CP) 

Reports repeated lines in a file, uniq: uniq(C) 

The Micnet default commands file, micnet; micnet(F) 

The Micnet system identification file, systemid: systemid(F) 

\]\}CP uuschedlimxi file, maxuuscheds: maxuuscheds(F) 

UUCP limit file, maxuuxqts: maxuuxqts(F) 

Undoes a previous get of an SCCS file, unget: unget(CP) 

a delta (change) to an SCCS file, delta: Makes delta(CP) 

a new filename to an existing file, link: Links link(S) 

and modification times of a file, touch: Updates access . , . touch(C) 

checksum and counts blocks in a file, sum: Calculates sum(C) 

chmod: Changes mode of a file chmod(S) 

chsize: Changes the size of a file. . . . chsize(S) 

core: Format of core image file core(F) 

"crontab: user crontab" file 

ctags: Creates a tags file ctags(CP) 

dd: Converts and copies a file dd(C) 

devices: Format of UUCP devices file devices(F) 

dialers: Format of UUCP Dialers file dialers(F) 

directory entries and put in a file, getdents: read getdents(S) 

entries in a common object file linenum: line number .... linenum(F) 
execlp, exeevp: Executes a file, /exeev, execle, exeeve, . . . exec(S) 

fields of each line of a file, cut: Cuts out selected .... cut(C) 

filelength: Gets the length of a file fileleng(DOS) 

for and processes a pattern in a file, awk: Searches awk(C) 

format of curses screen image file. scr_dump: scr_dump(F) 

group: Format of the group file group(M) 

grpchcck: Checks group file grpcheck(C) 

header for a common object file scnhdr: section scnhdr(F) 

information for a common object file reloc: relocation reloc(F) 

issue: issue identification file issue(F) 

In: Makes a link to a file. ln(C) 

mem, kmem: Memory image file mem(M) 

mestbl: create a messages locaie file mestbl(M) 

nl: Adds line numbers to a file nl(C) 

nuU: The null file null(F) 

of UUCP dial-code abbreviations file, dialcodes: Format dialcodes(F) 
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or a special or ordinary file, mknod: Makes a directory, . . mknod(S) 

passwd: The password file passwd(F) 

poll: Format of UUCP Poll file poU(F) 

printable strings in an object file, strings: Finds the strings(CP) 

prs: Prints an SCCS file prs(CP) 

pwcheck: Checks password file pwcheck(C) 

read: Reads from a file read(S) 

remove extra blank lines from a file rmb: rmb(M) 

scesfile: Format of an SCCS file sccsfile(F) 

specified in the s d e v i c e file Aist of vectors currently . . . vectorsinuse(ADM) 
specified in the mdevice file /device numbers currently . . majorsinuse(ADM) 

systems: Format of UUCP Systems file systems(F) 

tmpfile: Creates a temporary file tmpfile(S) 

uncompress: Uncompress a stored file compress(C) 

UUCP directories and permissions file uucheck: check the uucheck(ADM) 

val: Validates an SCCS file val(CP) 

write: Writes to a file write(S) 

zcat: Display a stored file compress(C) 

fuser: identify processes using a file or file structure fuser(C) 

times, utime: Sets file access and modification . . . utime(S) 

Idfcn: common object file access routines ldfcn(F) 

cpio: Copies file archives in and out cpio(C) 

fcntl: file control options fcntl(M) 

uupick: Public XENIX-to-XENIX file copy, uuto, uuto(C) 

umask: Sets and gets file creation mask umask(S) 

close: Closes a file descriptor. . close(S) 

dup, dup2: Duplicates an open file descriptor dup(S) 

file: Determines file type file(C) 

sact: Prints current SCCS file editing activity sact(CP) 

endpwent: Gets password file entry, /getpwnam, setpwent, . getpwent(S) 

putpwent: Writes a password file entry putpwent(S) 

setgrent, endgrent: Get group file entry, /getgrgid, getgmam, . . getgrent(S) 

utmpname: Accesses utmp file entry, endutent, getut(S) 

grep, egrep, fgrep: Searches a file for a pattern grcp(C) 

proto: prototype job file for at proto(ADM) 

open: Opens file for reading or writing open(S) 

writing, sopen: Opens a file for shared reading and .... sopen(DOS) 

uudecode: decode a binary file for transmission via mail . . . uuencode(C) 

uuencode: encode a binary file for transmission via mail . . . uuencode(C) 

ar: Archive file format. . ar(F) 

mdevice: file format mdevice(F) 

mfsys: file format mfsys(F) 

mmne: file format mtune(F) 

sdevice: file format sdevice(F) 

sfsys: file format sfsys(F) 

stune: file format stune(F) 

pnch: file format for card images .... pnch(F) 

intro: Introduction to file formats lntro(F) 

mkstr: Creates an error message file from C source mkstr(CP) 

implementation-specific/ limits: file header for limits(F) 

files filehdr: file header for common object . . filehdr(F) 
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constants unistd: file header for symbolic unistd(F) 

Changes executable binary file headers, fixhdr: fixhdr(C) 

split: Splits a file into pieces split(C) 

/Finds the slot in the utmp file of the current user. ttyslot(S) 

purge(C) purge: the policy file of the sanitization utility . . . purge(F) 

rename: renames a file or directory rename(DOS) 

the access permissions of a file or directory. /Changes .... chmod(C) 
one. creat: Creates a new file or rewrites an existing .... creat(S) 

Gets the current position of the file pointer, tell: tell(DOS) 

Iseek: Moves read/write file pointer. Iseek(S) 

/ftell, rewind: Repositions a file pointer in a stream fseek(S) 

locking: Locks or unlocks a file region for reading or/ .... locking(S) 

stat, fstat: Gets file status stat(S) 

mount: Mounts a file structure mount(ADM) 

umount: Dismounts a file structure umount(ADM) 

/processes using a file or file structure fuser: identify . . . fuser(C) 

syms: common object file symbol table format syms(F) 

Prints or changes the name of a file system fsname: ...... fsname(ADM) 

literal copy of UNIX file system volcopy: make .... volcopy(ADM) 

mkfs: Constructs a file system mkfs(ADM) 

mount: Mounts a file system mount(S) 

umount: Unmounts a file system umount(S) 

UNIX system volume fs: file system - format of fs(F) 

backup: Performs incremental file system backup backup(ADM) 

fsdb: File system debugger fsdb(ADM) 

volume, file system: Format of a system . . filesystem(F) 

fstyp: determine file system identifier fstyp(ADM) 

directory entry, dirent: file system independent dirent(F) 

fstatfs: get file system information statfs(S) 

statfs: get file system information statfs(S) 

commands, fstab: File system mount and check . . . fstab(F) 

quot: Summarizes file system ownership quot(C) 

XENIX incremental file system restorer. /Invokes . . . xrestore(ADM) 

restore, restor: Invokes incremental file system restorer. restore(ADM) 

ustat: Gets file system statistics ustat(S) 

fsstat: report file system status fsstat(ADM) 

mnttab: Format of mounted file system table mnttab(F) 

- mount, unmount multiple file systems /umountall mountall(ADM) 

fsck: Checks and repairs file systems fsck(ADM) 

labelit: provide labels for file systems labelit(ADM) 

haltsys, reboot: Qoses out the file systems and shuts down the/ . haltsys(ADM) 

fsck. checklist: List of file systems processed by .... checklist(F) 

serial/ consoleprint: Print file to printer attached to a .... consoleprint(ADM) 

/a XENIX-style Micnet routing file to MMDF format mnlist(ADM) 

/converts XENIX-style aliases file to MMDF format mmdfalias(ADM) 

XENIX-style UUCP routing file to MMDF format, /a uulist(ADM) 

tsort: Sorts a file topologically tsort(CP) 

the scheduler for the UUCP file transport program uusched: . . uusched(ADM) 

ftw: Walks a file tree ftw(S) 

file: Determines file type file(C) 

umask: Sets file-creation mode mask umask(C) 
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object files filehdr: file header for common . . filehdr(F) 

file, filelength: Gets the length of a . . fileleng(DOS) 

mktemp: Makes a unique filename mktemp(S) 

ctermid: Generates a filename for a terminal ctermid(S) 

link: Links a new filename to an existing file. . . . link(S) 
status, ferror, feof, clearerr, fileno: Determines stream .... feiror(S) 

Creates and administers SCCS files, admin: admin(CP) 

Format of tty device mapping files, mapchan: mapchan(F) 

Gets name list entries from files, xlist, fxlist: xlist(S) 

access and modification dates of files, settime: Changes the .... settime(ADM) 
and prints process accounting files, acctcom: Searches for ... acctcom(ADM) 

bfs: Scans big files bfs(C) 

cat: Concatenates and displays files cat(C) 

cmp: Compares two files cmp(C) 

copy: Copies groups of files copy(C) 

cp: Copies files cp(C) 

difB: Compares three files difB(C) 

diff: Compares two text files difi(C) 

dosrm, dosrmdir: Access DOS files, dosls, dos(C) 

fcntl: Controls open files fcntl(S) 

file header for common object files filehdr: filehdr(F) 

find: Finds files find(C) 

format specification in text files fspec: fspec(F) 

lines common to two sorted files, comm: Selects or rejects . . comm(C) 

merge or add total accounting files acctmerg: acctmerg(ADM) 

miscellaneous features and files, /to machine related .... Intro(HW) 

mknod: Builds special files mknod(C) 

parts of executable binary files, hdr: Displays selected . . . hdr(CP) 

paste: Merges lines of files paste(C) 

purge: overwrites specified files purge(C) 

semaphores and record locking on files, lockf: Provide lockf(S) 

sort: Sorts and merges files sort(C) 

string, format of graphical files gps: graphical primitive . . . gps(F) 

tar: Archives files tar(C) 

to miscellaneous features and files, intro: Introduction Intro(M) 

top.next: The Micnet topology files, top, top(F) 

unpack: Compresses and expands files, pack, peat, pack(C) 

what: Identifies files what(C) 

esplit: Splits files according to context csplit(C) 

rep: Copies files across XENIX systems. . . . rcp(C) 

integrity: examine system files against authentication/ . . . integrity(ADM) 

link, unlink: link and unlink files and directories link: .... link(ADM) 

mv: Moves or renames files and directories mv(C) 

idmkinit: read files containing specifications . . idmkinit(ADM) 

transit queue: MMDF queue files for storing mail in queue(ADM) 

translate: Translates files from one format to another . . translate(C) 
auditd: read audit collection files generated by the audit/ . . . auditd(ADM) 

cleantmp: remove temporary files in directories specified . . . cleantmp(ADM) 

hd: Displays files in hexadecimal format. . . . hd(C) 

od: Displays files in octal format od(C) 

dumpdir: Prints the names of files on a backup archive dumpdir(C) 
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imprint: Prints text files on an IMAGEN printer. . . . imprint(C) 

pr: Prints files on the standard output. . . . pr(C) 

rm,rmdir: Removes files or directories. ....... rm(C) 

sdiff. Compares files side-by-side sdifi(C) 

coffconv: Convert 386 COFF files to XENIX format cofifconv(M) 

bdiffi Compares files too large for diff. bdiffi^C) 

control files, uuinstall: Administers UUCP uuinstall(ADM) 
ISO-9600 CD-ROM filesystem hs: High Sierra .... hs(F) 

mnt: Mount a filesystem mnt(C) 

High Sierra ISO-9660 CD-ROM filesystem hs(F) 

Interactive, error-checking filesystem backup fsave: .... fsave(ADM) 

XENIX incrementad filesystem backup. /Performs . . xbackup(ADM) 
/AT&T UNIX incremental filesystem backup restore .... restore(ADM) 

directory entry dirent: file-system-independent dirent(F) 

/Default information for mounting filesystems filesys(F) 

time dcopy: copy UNIX filesystems for optimal access . . dcopy(ADM) 

greek: select terminal filter . greek(C) 

pscat: ASCII-to-PostScript filter pscat(C) 

tplot: graphics filters tplot(ADM) 

col: Filters reverse linefeeds col(C) 

service Ip filter: administer filters used with the LP print . . . lpfilter(ADM) 
driver object module, routines: finds driver entry points in a ... routines(ADM) 

find: Finds files find(C) 

finger. Finds information about users. . . finger(C) 
logname: Finds login name of user. .... logname(S) 
object library, lorder: Finds ordering relation for an ... lorder(CP) 
hashmake, spellin, hashcheck: Finds spelling errors, spell, . . . spell(C) 

ttyname, isatty: Finds the name of a terminal. . . . ttyname(S) 

an object file, strings: Finds the printable strings in ... strings(CP) 

of the current user, ttyslot: Finds the slot in the utmp file . . . ttyslot(S) 

users, finger: Finds information about . . finger(C) 

dbminit, fetch, store, delete, firstkey, nextkey: Performs/ . . . dbm(S) 

bad track table, badtrk: Scans fixed disk for flaws and creates . . badtik(ADM) 

binary file headers, fixhdr. Changes executable . . . fixhdr(C) 

badtrk: Scans fixed disk for flaws and creates bad track/ . . . badtrk(ADM) 

frexp, Idexp, modf: Splits floating-point number into a/ . . . frexp(S) 

/fmod: Performs absolute value, floor, ceiling and remainder/ . . . floor(S) 

Performs absolute value, floor,/ floor, fabs, ceil, fmod: floor(S) 

diskemp: Copies or compares floppy disks, diskep, diskcp(C) 

format: format floppy disks format(C) 

fdswap: Swaps default boot floppy drive fdswap(ADM) 

cflow: Generates C flow graph cflow(CP) 

buffers, flushall: Flushes all output .... flushall(DOS) 

fclose, fftush: Closes or flushes a stream fclose(S) 

flushall: Flushes all output buffers flushall(DOS) 

CPU. shutdn: Flushes block I/O and halts the . . shutdn(S) 

floor,/ floor, fabs, ceil, fmod: Performs absolute value, . . floor(S) 

device, vidi: Sets the font and video mode for a video . . vidi(C) 

stream, fopen, freopen, fdopen: Opens a . fopen(S) 
folk: Creates a new process. . . . fork(S) 

Convert 386 COFF files to XENIX format, coffconv: ....... coffconv(M) 
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Displays files in hexadecimal format, hd: hd(C) 

aliases file to MMDF forniat. /converts XENIX-style . . mmdfalias(ADM) 

ar: Archive file format ar(F) 

backup: Incremental dump tape format backup(F) 

common object file symbol table format syms: syms(F) 

mdevice: file format mdevice(F) 

mfsys: file format mfsys(F) 

mtune: file format mmne(F) 

od: Displays files in octal format od(C) 

routing file to MMDF format. AJUCP uulist(ADM) 

routing file to MMDF format, /a XENIX-style Micnet . . mnlist(ADM) 

sdevice: file format sdevice(F) 

sfsys: file format sfsys(F) 

stune: file format stune(F) 

tar: archive format tar(F) 

strftime: format date/time string strftime(S) 

format: format floppy disks format(C) 

pnch: file format for card images pnch(F) 

86rel: Intel 8086 Relocatable Format for Object Modules. . . . 86rel(F) 

format: format floppy disks. . . . format(C) 

dir: Format of a directory dir(F) 

file system: Format of a system volume. . . . filesystem(F) 

newform: Changes the forniat of a text file newform(C) 

inode: Format of an inode inode(F) 

scesfile: Format of an SCCS file sccsfile(F) 

editor output. a.out: Format of assembler and link . . . a.out(F) 

file, "terminfo:" Format of compiled terminfo . . . terminfo(F) 

core: Format of core image file core(F) 

cpio: Format of cpio archive cpio(F) 

file. scr_dump: format of curses screen image . . scr_dump(F) 

gps: graphical primitive string, format of graphical files gps(F) 

table, mnttab: Format of mounted file system . . mnttab(F) 

file, acet: Format of per-process accounting . acct(F) 

volume fs: file system - formatof UNIX system fs(F) 

volume fs: file system formatof UNIX system fs(F) 

group: Format of the group file group(M) 

files, mapehan: Format of tty device mapping . . mapchan(F) 

devices: Format of UUCP devices file. . . devices(F) 

abbreviations file, dialcodes: Formatof UUCP dial-code .... dialcodes(F) 
dialers: Formatof UUCP Dialers file. . . . dialers(F) 

permissions: Format of UUCP Permissions file. . permissions(F) 

poU: Format of UUCP Poll file poU(F) 

sysfiles: Format of UUCP Sysfiles file. . . sysfiles(F) 

systems: Format of UUCP Systems file. . . systems(F) 

files fspec: format specification in text . . . fspec(F) 

Translates files from one format to another translate: . . . translate(C) 

intro: Introduction to file formats Intro(F) 

cscanf: Converts and formats console input cscanf(DOS) 

fscanf, sscanf: Converts and formats input, scanf, scanf(S) 

entries, utmp, wtmp: Formats of utmp and wtmp .... utmp(F) 

cprintf: Formats output cprintf(DOS) 
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printf, Iprintf, sprintf: 
vfprintf, vsprintf: Prints 
service Ipforms: administer 
Rational FORTRAN into standard 
ratfor: Converts Rational 
and segment, 
output, printf, 
segment. ^_off, 
character to a stream, 
word on a/ putc, putchar, 
stream, fputc, 
stream, puts, 
binary input and output, 
main memory, malloc, 
fopen, 

floating-point number into a/ 
UNIX system volume 
error-checking filesystem/ 
formats input, scanf, 
of file systems processed by 
systems. 

Repositions a file pointer in a/ 
name of a file system 
text files 

semi-automated system backups 
status 

check commands. 

stat, 

information, 
identifier 
file pointer in a/ fseek, 
time, 

communication package. 

function and complementary error 
gamma: Performs log gamma 
matherr: Error-handling 
prof: profile within a 
function, erf, erfc: Error 
setkey: Assigns the 
Performs screen and cursor 
atan2: Performs trigonometric 
cosh, tanh: Performs hyperbolic 
floor, ceiling and remainder 
jn, yO, yl, yn: Performs Bessel 
logarithm, power, square root 
nextkey: Performs database 
performs UNIX backup 
sysi86: machine specific 
tgoto, tputs: Performs terminal 



Formats output. 

formatted output of a/ vprintf, . . 
forms used with the LP print . . . 
FORTRAN, ratfor: Converts . . . 
FORTRAN into standard FORTRAN. 
fjp_ofif, fp_seg: Return offeet . . . 

I^rintf, sprintf: Formats 

fp_seg: Return offeet and .... 

fputc, fputchar: Write a 

fputc, putw: Puts a character or . . 
fputchar: Write a character to a . . 

fputs: Puts a string on a 

fread, fwrite: Performs buffered . . 
free, realloc, calloc: Allocates . . 
freopen, fdopen: Opens a stream, 
frexp, Idexp, modf: Splits . . . . 
fs: file system - format of .... 

fsave: Interactive, 

fscanf, sscanf: Converts and . . . 

fsck. checklist: List 

fsck: Checks and repairs file ... 
fsdb: File system debugger. . . . 

fseek, ftell, rewind: 

fsname: Prints or changes the . . . 
fspec: format specification in . . . 
fsphoto: Performs periodic .... 

fsstat: report file system 

fstab: File system mount and . . . 

fstat: Gets file status 

fstatfs: get file system 

fstyp: determine file system . . . 
ftell, rewind: Repositions a ... 

ftime: Gets time and date 

ftok: Standard interprocess .... 

ftw: Walks a file tree 

function, erf, erfc: Error .... 

function 

function 

function 

function and complementary error . 

function keys 

functions, curses: ....... 

functions, /asin, acos, atan, . . . 

functions, sinh, 

functions, /absolute value, .... 

functions, bessel, jO, j 1 

functions, /exponential, 

functions, /delete, firstkey, . . . 

functions backup: 

functions. 

ftinctions. /tgetflag, tgetstr, . . . 



printf(S) 

vprintf(S) 

Ipforms(ADM) 

ratfor(CP) 

ratfor(CP) 

fp_seg(DOS) 

printf(S) 

fp_seg(DOS) 

fputc(DOS) 

putc(S) 

fputc(DOS) 

puts(S) 

fread(S) 

malloc(S) 

fopen(S) 

frexp(S) 

fs(F) 

fsave(ADM) 

scanf(S) 

checklist(F) 

fsck(ADM) 

fsdb(ADM) 

fseek(S) 

fsname(ADM) 

fspec(F) 

fsphoto(ADM) 

fsstat(ADM) 

fstab(F) 

stat(S) 

statfs(S) 

fstyp(ADM) 

fseek(S) 

time(S) 

stdipc(S) 

ftw(S) 

erf(S) 

gamma(S) 

matherr(S) 

prof(M) 

erf(S) 

setkey(C) 

curses(S) 

trig(S) 

sinh(S) 

floor(S) 

bessel(S) 

exp(S) 

dbm(S) 

backup(ADM) 

sysi86(S) 

termcap(S) 
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to DOS cross development functions, intro: Introduction . . intro(DOS) 

math: math functions and constants math(M) 

terminals hp: handle special ftmctions of Hewlett-Packard . . . hp(C) 

300: 300, 300s - handle special functions of DASI 300/ 300(C) 

450/ 450: handle special functions of the DASI 450(Q 

input and output, fread, fwrite: Performs buffered binary . fread(S) 

manipulate connect accounting/ fwtmp: fwtmp, wtmpfix: fwtmp(ADM) 

connect accounting/ fwtmp: fwtmp, wtmpfix: manipulate . . . fwtmp(ADM) 

from files, xlist, Mist: Gets name list entries . . . xlist(S) 

gamma: Performs log gamma function gamma(S) 

function, gamma: Performs log gamma . . . gamma(S) 

conversions, ecvt, fcvt, gcvt: Performs output ecvt(S) 

adb: Invokes a general-purpose debugger adb(CP) 

report, imacct: Generate an IMAGEN accounting . imacct(C) 

user ID diskusg: generate disk accounting data by . diskusg(ADM) 

and /read audit collection files generated by the audit subsystem . auditd(ADM) 

terminal, ctermid: Generates a filename for a .... ctermid(S) 
rand, srand: Generates a random number. . . . rand(S) 

random: Generates a random number. . . . random(C) 

makekey: Generates an encryption key. . . . makekey(M) 

abort: Generates an lOT fault abort(S) 

cflow: Generates C flow graph cflow(CP) 

cross-reference, cxref: Generates C program cxref(CP) 

numbers, ncheck: Generates names from inode . . . ncheck(ADM) 

analysis, lex: Generates programs for lexical . . lex(CP) 

srand48, seed48, lcong48: Generates uniformly distributed. . drand48(S) 

MMDF queue status report generator checkque: checkque(ADM) 

value machid: machid, i386 get processor type truth machid(C) 

character or word from a/ getc, getchar, fgetc, getw: Gets . . getc(S) 

getch: Gets a character getch(DOS) 

character or word from a/ getc, getchar, fgetc, getw: Gets .... getc(S) 

character, getche: Gets and echoes a .... getche(DOS) 

real-time clock getclk: gets string from getclk(M) 

current working directory, getcwd: Get the pathname of . . . getcwd(S) 

and put in a file, getdents: read directory entries . . getdents(S) 

getuid, geteuid, getgid, getegid: Gets real user,/ getuid(S) 

environment name, getenv: Gets value for getenv(S) 

real user, effective/ getuid, geteuid, getgid, getegid: Gets . . . getuid(S) 

effective/ getuid, geteuid, getgid, getegid: Gets real user, . . getuid(S) 

setgrent, endgrent: Get group/ getgrent, getgrgid, getgmam, . . . getgrent(S) 

endgrent: Get group/ getgrent, getgrgid, getgmam, setgrent, . . . getgrent(S) 

Get group/ getgrent, getgrgid, getgmam, setgrent, endgrent: . . . getgrent(S) 

getlogin: Gets login name getlogin(S) 

argument vector, getopt: Gets option letter from . . getopt(S) 

getopt: Parses command options. . getopt(C) 

options getopts: getopts, getoptcvt - parse command . . . getopts(C) 

command options getopts: getopts, getoptcvt - parse .... getopts(C) 
parse command options getopts: getopts, getoptcvt - ... getopts(C) 

getpass: Reads a password. . . . getpass(S) 

process group, and/ getpid, getpgrp, getppid: Gets process, . . getpid(S) 

process, process group, and/ getpid, getpgrp, getppid: Gets . . getpid(S) 
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group, and/ getpid, getpgrp, getppid: Gets process, process . . getpid(S) 
user ID. getpw: Gets password for a given . getpw(S) 
setpwent, endpwent: Gets/ getpwent, getpwuid, getpwnam, , . getpwent(S) 
Gets/ getpwent, getpwuid, getpwnam, setpwent, endpwent: . getpwent(S) 

endpwent: Gets/ getpwent, getpwuid, getpwnam, setpwent, . . getpwent(S) 

getch: Gets a character. getch(DOS) 

fgetc, fgetchar: Gets a character from a stream. . . fgetc(DOS) 

an event queue. ev_getdev: Gets a list of devices feeding . . . ev_getdev(S) 
shmget: Gets a shared memory segment. . . shmget(S) 

cgets: Gets a string cgets(DOS) 

gets, fgets: Gets a string from a stream. . . . gets(S) 

input, gets: Gets a string from the standard . . gets(CP) 

getche: Gets and echoes a character. . . . getche(DOS) 

ulimit: Gets and sets user limits ulimit(S) 

getc, getchar, fgetc, getw: Gets character or word from a/ . . getc(S) 

dosexterr: Gets DOS error messages dosexter(DOS) 

nlist: Gets entries from name list. . . . nlist(S) 

a stream, gets, fgets: Gets a string from . . . gets(S) 

umask: Sets and gets file creation mask umask(S) 

stat, fstat: Gets file status stat(S) 

ustat: Gets file system statistics ustat(S) 

standard input, gets: Gets a string from the ... gets(CP) 

getlogin: Gets login name getlogin(S) 

logname: Gets login name logname(C) 

msgget: Gets message queue msgget(S) 

files, xlist, fxlist: Gets name list entries from . . . xlist(S) 

system, uname: Gets name of current XENIX . . . uname(S) 

vector, getopt: Gets option letter from argument . getopt(S) 

/getpwnam, setpwent, endpwent: Gets password file entry getpwent(S) 

ID. getpw: Gets password for a given user . . getpw(S) 

times, times: Gets process and child process . . times(S) 

getpid, getpgip, getppid: Gets process, process group, and/ . getpid(S) 

real/ /geteuid, getgid, getegid: Gets real user, effective user, . . . getuid(S) 

semget: Gets set of semaphores semget(S) 

getclk: gets string from real-time clock . . getclk(M) 

file pointer, tell : Gets the current position of the . . tell(DOS) 

filelength: Gets the length of a file fileleng(DOS) 

cuserid: Gets the login name of the user. . . cuserid(S) 

tty: Gets the terminal’s name tty(C) 

time, ftime: Gets time and date time(S) 

getenv: Gets value for environment name. . getenv(S) 

and terminal settings used by getty. "gettydefs: Speed" 

security actions for init and getty initcond: special initcond(ADM) 

modes, speed, and line/ getty: Sets terminal type, .... getty(M) 
ct: spawn getty to a remote terminal .... ct(C) 

settings used by getty. "gettydefs: Speed and 

getegid: Gets real user,/ getuid, geteuid, getgid, getuid(S) 

from a/ getc, getchar, fgetc, getw: Gets character or word . . . getc(S) 
of directories. Is: Gives information about contents . ls(C) 
date and time/ ctime, localtime, gmtime, asctime, tzset: Converts . ctime(S) 

non-obviousness, goodpw: Check a password for . . goodpw(ADM) 
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longjmp: Performs a nonlocal “goto**, setjmp, setjmp(S) 

iind checks access to a resource governed by a semaphore. /Awaits waitsem(S) 

format of graphical files gps: graphical primitive string, . . gps(F) 

cflow: Generates C flow graph cflow(CP) 

graph: draw a graph graph(ADM) 

sag: system activity graph sag(ADM) 

graph: draw a graph graph(ADM) 

primitive string, format of graphical files gps: graphical . . gps(F) 

format of graphical files gps: graphical primitive string, .... gps(F) 

tplot: graphics filters tplot(ADM) 

plot: graphics interface plot(F) 

greek: select terminal filter .... gneek(C) 
file for a pattern, grep, egrep, fgrep: Searches a . . grep(C) 

newgrp: Logs user into a new group newgip(C) 

/real user, effective user, real group, and effective group IDs. . . getuid(S) 
/getppid: Gets process, process group, and parent process IDs. . . getpid(S) 
passwd: Change login, group, or dialup shell password. . . passwd(C) 

copy: Copies groups of files copy(C) 

updates, and regenerates groups of programs. /Maintains, . make(CP) 
grpcheck: Checks group file. . . . grpcheck(C) 

signals, ssignal, gsignal: Implements software . . ssignal(S) 

shutdn: Flushes block I/O and halts the CPU shutdn(S) 

file systems and shuts down the/ haltsys, reboot: Closes out the . . haltsys(ADM) 

Hewlett-Packard terminals hp: handle special functions of ... . hp(C) 

DASI 300/ 300: 300, 300s handle special functions of ... . 300(C) 

DASI/ 300: 300, 300s - handle special functions of ... . 300(C) 

DASI 450 terminal 450: handle special functions of the . . 450(C) 

nohup: Runs a command immune to hangups and quits nohup(C) 

cmchk: Reports hard disk block size cmchk(C) 

dparam: Displays/changes hard disk characteristics dparam(ADM) 

hd: Internal hard disk drive hd(HW) 

scsinfo: display current SCSI hard disk information scsinfo(ADM) 

and size/ display hard disk partition, division, . . . dlayout(ADM) 

and removing/ hdutil: hard disk utility for displaying . . hdutil(ADM) 

uconfig: system hardware changes uconfig(ADM) 

hostid: print unique hardware ID hostid(ADM) 

hcreate, hdestroy: Manages hash search tables, hsearch, . . . hsearch(S) 

spell, hashmake, spellin, hashcheck: Finds spelling/ .... spell(C) 
routing/ /builds the MMDF hashed database of alias and . . . dbmbuild(ADM) 

Finds spelling errors, spell, hashmake, spellin, hashcheck: . . spell(C) 

search tables, hsearch, hcreate, hdestroy: Manages hash . hsearch(S) 

hexadecimal format, hd: Displays files in hd(C) 

hd: Internal hard disk drive. . . . hd(HW) 

tables, hsearch, hcreate, hdestroy: Manages hash search . . hsearch(S) 

executable binary files, hdr: Displays selected parts of . . hdr(CP) 

limits: file header for/ limits(F) 

scnhdr: section header for a common object file . . scnhdr(F) 

filehdr: file header for common object files . . filehdr(F) 

unistd: file header for symbolic constants . . unistd(F) 

Changes executable binary file headers, fixhdr: fixhdr(C) 

user, hello: Send a message to another . hello(ADM) 
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program, assert: Helps verify validity of assert(S) 

hp: handle special functions of Hewlett-Packard terminals .... hp(C) 

hd: Displays files in hexadecimal format hd(C) 

CD-ROM filesystem hs: High Sierra/ISO-9600 hs(F) 

filesystem hs: High Sierra/ISO-9660 CD-ROM . hs(F) 
layers: protocol used between host and windowing terminal/ . . layers(M) 

terminal jagent: host control of windowing .... jagent(M) 

Machine: Description of host machine machine(HW) 

Hewlett-Packard terminals hp: handle special functions of . . hp(C) 

Manages hash search tables, hsearch, hcreate, hdestroy: .... hsearch(S) 

information, hwconfig: Read the configuration . hwconfig(ADM) 

sinh, cosh, tanh: Performs hyperbolic functions sinh(S) 

Euclidean distance, hypot, cabs: Determines hypot(S) 

i286emul: emulate 80286 .... i286emul(C) 

value machid: machid, 1386 - get processor type truth . . machid(C) 

Gets password for a given user ID. getpw: getpw(S) 

chgrp: Changes group ID chgrp(C) 

chown: Changes owner ID chown(C) 

disk accounting data by user ID diskusg: generate diskusg(ADM) 

setpgrp: Sets process group ID setpgrp(S) 

unique hardware ID hostid: print hostid(ADM) 

hard disks /display logical SCSI ID numbers for current SCSI . . . scsinfo(ADM) 

IDs and names id: print user and group id(ADM) 

and names, id: Prints user and group IDs . . . id(C) 

kernel idbuild: build new UNIX system . idbuild(ADM) 
information idcheck: returns selected .... idcheck(ADM) 

issue: issue identification file issue(F) 

systemid: The Micnet system identification file systemid(F) 

fstyp: determine file system identifier fstyp(ADM) 

devnm: Identifies device name devnm(C) 

what: Identifies files what(C) 

file or file structure fuser: identify processes using a . . . . fuser(C) 

or file structure fuser: identify processes using a file . . fuser(C) 

or get device driver/ idinstall: add, delete, update, . . . idinstall(ADM) 

idleout: Logs out idle users idleout(ADM) 

idleout: Logs out idle users. . . . idleout(ADM) 
specifications idmkinit: read files containing . . idmkinit(ADM) 
group, and parent process IDs. /Gets process, process . . . getpid(S) 

real group, and effective group IDs. /real user, effective user, . . getuid(S) 

setgid: Sets user and group IDs. setuid, setuid(S) 

id: Prints user and group IDs and names id(C) 

id: print user and group IDs and names id(ADM) 

idspace: investigates free space . . idspace(ADM) 
a tunable parameter idtune: attempts to set value of . . idtune(ADM) 
accounting report, imacct: Generate an IMAGEN . . imacct(C) 

core: Format of core image file. core(F) 

format of curses screen image file. scr_dump: scr_dump(F) 

mem, kmem: Memory image file mem(M) 

imacct: Generate an IMAGEN accounting report. . . . imacct(C) 

imprint: Prints text files on an IMAGEN printer imprint(C) 

crash: examine system images crash(ADM) 
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pnch: file format for card images pnch(F) 

nohup: Runs a command immune to hangups and quits. . . nohup(C) 

limits: file header for implementation-specific/ .... limits(F) 

ssignal, gsignal: Implements software signals. . . . ssignal(S) 

IMAGEN printer, imprint: Prints text files on an . . imprint(C) 

event input. ev_gindev: include/exclude devices for ... ev_gindev(S) 
baclcup: Incremental backup tape format. . backup(F) 

restore, restor: Invokes incremental file system/ restore(ADM) 

xrestore: Invokes XENIX incremental file system/ xrestore(ADM) 

backup: Performs incremental file system backup. . . backup(ADM) 

restore: AT&T UNIX incremental filesystem backup/ . . restore(ADM) 

xbackup: Performs XENIX incremental filesystem backup. . . xbackup(ADM) 

dirent: file system independent directory entry. . . . dirent(F) 

and teletypes last: Indicate last logins of users . . . last(C) 

"terminfo descriptions" infocmp: compare or print out . . 

/Default backup device informatioa archive(F) 

database of alias and routing information, /hashed dbmbuild(ADM) 

fstatfs: get file system infonnation statfs(S) 

hwconfig: Read the configuration information hwconfig(ADM) 

prints lineprinter status information. Ipstat: Ipstat(C) 

pstat: Reports system information pstat(Q 

statfs: get file system information statfs(S) 

vdinfo: display virtual disk information vdinfo(ADM) 

initialization, init, inir: Process control init(M) 

special security actions for init and getty initcond: initcond(ADM) 

initialization, init, inir: Process control .... init(M) 

actions for init and getty initcond: special security .... initcond(ADM) 

init, inir: Process control initialization init(M) 

vddaemon: virtual disk initialization vddaemon(ADM) 

brc: brc, bcheckrc - system initialization procedures brc(ADM) 

process, popen, pclose: Initiates I/O to or from a popen(S) 

terminals file, inittab: Alternative login .... inittab(F) 

clri: Clears inode clri(ADM) 

inode: Format of an inode inode(F) 

inode: Format of an inode inode(F) 

ncheck: Generates names from inode numbers nchcck(ADM) 

inp: Returns a byte inp(DOS) 

Converts and formats console input, cscanf: cscanf(DOS) 

Gets a string from the standard input, gets: gcts(CP) 

Opens an event queue for input. ev_open: ev_open(S) 

devices for event input. Anclude/exclude ..... ev_gindev(S) 

sscanf: Converts and formats input, scanf, fscanf, scanf(S) 

Performs standard buffered input and output, stdio: stdio(S) 

fwrite: Performs buffered binary input and output, fread, fread(S) 

Pushes character back into input stream, ungetc: ungetc(S) 

usemouse: Maps mouse input to keystrokes usemouse(C) 

uustat: UUCP status inquiry and job control uustat(C) 

script, install: Installation shell install(M) 

installpkg: install package installpkg(ADM) 

install: Installation shell script install(M) 

xinstall: XENIX installation shell script ..... xinstall(ADM) 
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removepkg: remove installed package removepkg(ADM) 

displaypkg: display installed packages displaypkg(ADM) 

installpkg: install package .... installpkg(ADM) 
creatsem: Creates an instance of a binary semaphore. . . creatsem(S) 

int86: Executes an interrupt. . . . int86(DOS) 

int86x: Executes an interrupt. . . int86x(DOS) 
call, intdos: Invokes a DOS system . . intdos(DOS) 

call, intdosx: Invokes a DOS system . . intdosx(DOS) 

atol, atoi: Converts string to integer, strtol, strtoI(S) 

the absolute value of a long integer, labs: Returns labs(DOS) 

abs: Returns an integer absolute value abs(S) 

A64a: Converts between long integer and base 64 ASCII. . . . a641(S) 

sputl, sgetl: Accesses long integer data in a/ sputl(S) 

between 3-byte integers and long integers. /ltol3: Converts .... 13tol(S) 

itoa: Converts numbers to integers itoa(DOS) 

/ltol3: Converts between 3-byte integers and long integers 13tol(S) 

Itoa: Converts long integers to characters ltoa(DOS) 

against authentication database integrity: examine system files . . integrity(ADM) 
for Object Modules. 86rel: Intel 8086 Relocatable Format . . 86rel(F) 
filesystem backup fsave: Interactive, error-checking .... fsave(ADM) 
system mailx: interactive message processing . . mailx(C) 

plot: graphics interface plot(F) 

rtc: real time clock interface rtc(HW) 

scsi: Small computer systems interface scsi(HW) 

swap: swap administrative interface swap(ADM) 

termio: General terminal interface termio(M) 

termios: POSIX general terminal interface termios(M) 

tty: Special terminal interface tty(M) 

cdrom: compact disk interface cdrom(HW) 

audit: audit subsystem interface device audit(ADM) 

STREAMS configuration interface for networking/ .... strmtune(ADM) 
activationy auditcmd: command interface for audit subsystem . . . auditcmd(ADM) 
authtsh: administrator interface for authorization/ .... authtsh(ADM) 

/, tty2[a-h] , tty2[A-H]: Interface to serial ports serial(HW) 

lpl,lp2: Line printer device interfaces. Ip, IpO, Ip(HW) 

Authentication/ authck: check internal consistency of authck(ADM) 

hd: Internal hard disk drive hd(HW) 

setlocale: Set or read international environment .... setlocale(S) 

locale: The international locale locale(M) 

spline: Interpolates smooth curve spline(CP) 

a restricted shell (command interpreter), rsh: Invokes .... rsh(C) 

sh: Invokes the shell command interpreter. sh(Q 

csh: Invokes a shell command interpreter with C-like syntax. . . csh(C) 
ipcs: Reports the status of inter-process communication/ . . ipcs(ADM) 
package, ftok: Standard interprocess communication . . . stdipc(S) 
pipe: Creates an interprocess pipe. ....... pipe(S) 

int86: Executes an interrupt. . int86(DOS) 

int86x: Executes an interrupt int86x(DOS) 

Suspends execution for a short interval, nap: nap(S) 

sleep: Suspends execution for an interval sleep(C) 

sleep: Suspends execution for an interval sleep(S) 
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services, library routines and/ intro: Introduces system Intro(S) 

Development System commands, intro: Introduces XENIX .... Intro(CP) 
commands, intro: Introduces XENIX .... Intro(C) 

miscellaneous features and/ intro: Introduction to Intro(M) 

development functions, intro: Introduction to DOS cross . intro(DOS) 
formats, inu-o: Introduction to file .... Intro(F) 
related miscellaneous features/ intro: Introduction to machine . . Intro(HW) 
library routines and/ intro: Introduces system services, . . . Intro(S) 
intro: Introduces XENIX commands. . . Intro(C) 

System commands, intro: Introduces XENIX Development . Intro(CP) 
development functions, intro: Introduction to DOS cross .... intro(DOS) 
intro: Introduction to file formats. . . . Intro(F) 
miscellaneous features/ intro: Introduction to machine related . . Intro(HW) 

features and files, intro: Introduction to miscellaneous . . Intro(M) 

idspace: investigates free space idspace(ADM) 

be: Invokes a calculator bc(C) 

yacc: Invokes a compiler-compiler. . . . yacc(CP) 

bdos: Invokes a DOS system call. . . . bdos(DOS) 

intdos: Invokes a DOS system call. . . . intdos(DOS) 

intdosx: Invokes a DOS system call. . . . intdosx(DOS) 

debugger, adb: Invokes a general-purpose .... adb(CP) 
m4: Invokes a macro processor. . . . m4(CP) 

calendar: Invokes a reminder service. . . . calendar(C) 

(command interpreter), rsh: Invokes a restricted shell .... rsh(C) 
red: Invokes a restricted version of. . . red(C) 

display/ vi, view, vedit: Invokes a screen-oriented .... vi(C) 
interpreter with C-like/ esh: Invokes a shell command .... csh(C) 

ex: Invokes a text editor ex(C) 

calculator, dc: Invokes an arbitrary precision . . dc(C) 

restore, restor: Invokes incremental file system/ . restore(ADM) 

incremental file/ xrestore: Invokes XENIX xrestore(ADM) 

sdb: Invokes symbolic debugger. . . . sdb(CP) 

cc: Invokes the C compiler cc(CP) 

evjnit: Invokes the event manager. . . . ev_init(S) 

Id: Invokes the link editor Id(CP) 

Id: Invokes the link editor. ld(M) 

interpreter, sh: Invokes the shell command . . . sh(C) 

sed: Invokes the stream editor sed(C) 

ed: Invokes the text editor ed(C) 

masm: Invokes the XENIX assembler. . . masm(CP) 

vdutil: restart I/O on a mirrored disk vdutil(ADM) 

shutdn: Flushes block I/O and halts the CPU. shutdn(S) 

select: synchronous I/O multiplexing select(S) 

popen, pclose: Initiates I/O to or from a process popen(S) 

devices, ioctl: Controls character ioctl(S) 

abort: Generates an lOT fault abort(S) 

semaphore set or shared memory, iperm: Removes a message queue, ipcrm(ADM) 
inter-process communication/ ipcs: Reports the status of .... ipcs(ADM) 
Aislower, isdigit, isxdigit, isalnum, isspace, ispunct,/ .... ctype(S) 
isdigit, isxdigity ctype, isalpha, isupper, islower, .... ctype(S) 

isverify: verifies ISAM database entries isverify(M) 
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/isprint, isgraph, iscntrl, isascii, tolower, touppery .... ctype(S) 

device, isatty: Checks for a character . . . isatty(DOS) 
terminal, ttyname, isatty: Finds the name of a .... ttyname(S) 

/ispunct, isprint, isgraph, iscntrl, isascii, tolowery ctype(S) 

/isalpha, isupper, islower, isdigit, isxdigit, isalnum,/ .... ctype(S) 

/isspace, ispunct, isprint, isgraph, iscntrl, isascii y ctype(S) 

ctype, isalpha, isupper, islower, isdigit, isxdigity .... ctype(S) 
state ismpx: return windowing terminal . ismpx(C) 
hs: High Sierra ISO-9600 CD-ROM filesystem . . hs(]^ 
filesystem hs: High Sierra ISO-9660 CD-ROM ...... hs(F) 

/isalnum, isspace, ispunct, isprint, isgraph, iscntriy ctype(S) 

/isxdigit, isalnum, isspace, ispunct, isprint, isgraphy .... ctype(S) 

/isdigit, isxdigit, isalnum, isspace, ispunct, isprinty .... ctype(S) 

issue: issue identification file issue(F) 

issue: issue identification file ... issue(F) 

isxdigity ctype, isalpha, isupper, islower, isdigit, ctype(S) 

/isupper, islower, isdigit, isxdigit, isalnum, isspace,/ .... ctype(S) 

news: Print news items news(C) 

integers, itoa: Converts numbers to .... itoa(DOS) 

Bessel functions, bessel, jO, jl,jn, yO, yl, yn: Performs . . bessel(S) 

Bessel functions, bessel, jO, jl,jn, yO, yl, yn: Performs .... bessel(S) 

windowing terminal j agent: host control of jagent(M) 

functions, bessel, jO,jl, jn, yO, yl, yn: Performs Bessel . . bessel(S) 

join: Joins two relations join(C) 

join: Joins two relations join(C) 

terminal jterm: reset layer of windowing . . jterm(C) 

jwin: print size of layer jwin(C) 

keystroke, kbhit: Checks the console for a . . kbhit(DOS) 
test keyboard support kbmode: Set keyboard mode or . . kbmode(ADM) 

builds a new UNIX system kernel. link_unix: link_unix(ADM) 

idbuild: build new UNIX system kernel idbuild(ADM) 

meisa: master EISA system kernel configuration file .... meisa(F) 

/or remove line disciplines from kernel configuration files .... idaddld(ADM) 
error: Kernel error output device. . . . error(M) 

makekey: Generates an encryption key makekey(M) 

keyboard: The PC keyboard keyboard(HW) 

support kbmode: Set keyboard mode or test keyboard . kbmode(ADM) 
Set keyboard mode or test keyboard support kbmode: . . . kbmode(ADM) 

keyboard: The PC keyboard. . . . keyboard(HW) 

setkey: Assigns the function keys setkey(C) 

kbhit: Checks the console for a keystroke kbhit(DOS) 

usemouse: Maps mouse input to keystrokes usemouse(C) 

killall: kill all active processes killall(ADM) 

process or a group of/ kill: Sends a signal to a ..... kill(S) 

kill: Terminates a process kill(C) 

processes killall: kill all active killall(ADM) 

mem, kmem: Memory image file. . . . mem(M) 

contents of directory. 1: Lists information about .... 1(C) 

3-byte integers and long/ 13tol, ltol3: Converts between . . 13tol(S) 
integer and base 64/ a641, 164a: Converts between long . . . a641(S) 

systems labelit: provide labels for file ... labelit(ADM) 
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labelit: provide labels for file systems labelit(ADM) 

of a long integer, labs: Returns the absolute value . . labs(DOS) 

cpp: The C language preprocessor cpp(CP) 

lint: Checks C language usage and syntax. . . . lint(CP) 

/chargefee, ckpacct, dodisk, lastlogin, monacct, nulladm,/ . . . acctsh(ADM) 

jwin: print size of layer jwin(Q 

login entry to show current layer relogin: rename relogin(ADM) 

shl: Shell layer manager shl(C) 

terminals layers: layer multiplexer for windowing . layers(Q 

jterm: reset layer of windowing terminal . . . jterm(C) 

windowing terminals layers: layer multiplexer for ... layers(C) 

host and windowing terminal/ layers: protocol used between . . layers(M) 

columns. Ic: Lists directory contents in . . . lc(C) 

distributed. srand48, seed48, lcong48: Generates uniformly . . drand48(S) 

Id: Invokes the link editor Id(CP) 

Id: Invokes the link editor ld(M) 

floating-point number/ frexp, Idexp, modf: Splits frexp(S) 

routines Idfcn: common object file access . ldfcn(F) 

filelength: Gets the length of a file fileleng(DOS) 

strlen: Returns the length of a string strlen(DOS) 

getopt: Gets option letter from argument vector. . . . getopt(S) 

banner: Prints large letters banner(C) 

lexical analysis, lex: Generates programs for ... lex(CP) 

lex: Generates programs for lexical analysis lex(CP) 

and update. Isearch, Ifind: Performs linear search . . . Isearch(S) 

Converts archives to random libraries, ranlib: ranlib(CP) 

ar: Maintains archives and libraries ar(CP) 

ordering relation for an object library, lorder: Finds lorder(CP) 

/Introduces system services, library routines and error/ .... Intro(S) 

maxuuscheds: UUCP uusched limit file maxuuscheds(F) 

maxuuxqts: UUCP uuxqt limit file maxuuxqts(F) 

ulimit: Gets and sets user limits ulimit(S) 

implementation-specific/ limits: file header for limits(F) 

line: Reads one line line(C) 

idaddld: add or remove line disciplines from kernel/ . . . idaddld(ADM) 

files idaddld: add or remove line disciplines from kernel/ . . . idaddld(ADM) 

Isearch, Ifind: Performs linear search and update Isearch(S) 

col: Filters reverse linefeeds col(C) 

a common object file linenum: line number entries in . . linenum(F) 

cancel: Send/cancel requests to lineprinter. Ip lp(C) 

Ipshut, Ipmove: Starts/stops the lineprinter request. Ipsched, . . . Ipsched(ADM) 

Ipadmin: Configures the lineprinter spooling system. . . . Ipadmin(ADM) 

Ipstat: prints lineprinter status information. . . Ipstat(C) 

Adds, reconfigures and maintains lineprinters. Ipinit: Ipinit(ADM) 

files, comm: Selects or rejects lines common to two sorted . . . comm(C) 

rmb: remove extra blank lines from a file rmb(M) 

uniq: Reports repeated lines in a file uniq(C) 

head: Prints the first few lines of a stream head(C) 

paste: Merges lines of files paste(C) 

wc: Counts lines, words and characters. . . . wc(C) 

directories link: link, unlink: link and unlink files and link(ADM) 



1-39 




Permuted Index 



Id: Invokes the link editor. Id(CP) 

Id: Invokes the link editor. ld(M) 

a.out: Format of assembler and link editor output a.out(F) 

unlink files and directories link: link, unlink: link and .... link(ADM) 
existing file, link: Links a new filename to an . link(S) 

In: Makes a link to a file ln(C) 

files and directories link: link, unlink: link and unlink . . . link(ADM) 

dosld: XENIX to MS-DOS cross linker. dosld(CP) 

existing file, link: Links a new filename to an ... . link(S) 

UNIX system kernel. link_unix: builds a new link_unix(ADM) 

and syntax, lint: Checks C language usage . . lint(CP) 

nlist: Gets entries from name list nlist(S) 

nm: Prints name list nm(CP) 

of a varargj argument list. /Prints formatted output . . . vprintf(S) 

varargs: variable argument list varargs(S) 

xlist, fxlist: Gets name list entries from files xlist(S) 

MMDF list: list processor channel for . . list(ADM) 

queue. ev_getdev: Gets a list of devices feeding an event . . ev_getdev(S) 
by fsck. checklist: List of file systems processed . . . checklist(F) 
majorsinuse: displays the list of major device numbers/ . . . majorsinuse(ADM) 
terminals: List of supported terminals. . . . terminals(M) 

swconfig: produces a list of the software/ swconfig(C) 

vectorsinuse: displays the list of vectors currently/ vectorsinuse(ADM) 

list: list processor channel for MMDF . list(ADM) 
nlsadmin: network listener service administration . . nlsadmin(ADM) 

cref: Makes a cross-reference listing cref(CP) 

columns. Ic: Lists directory contents in ... . lc(C) 

of directory. 1: Lists information about contents . 1(C) 

who: Lists who is on the system who(C) 

file system volcopy: make literal copy of UNIX volcopy(ADM) 

In: Makes a link to a file ln(C) 

locale: The international locale locale(M) 

mestbl: create a messages locale file mestbl(M) 

chrtbl: create a ctype locale table chrtbl(M) 

coltbl: create a collation locale table coltbl(M) 

curtbl: create a currency locale table curtbl(M) 

numtbl: Create a numeric locale table numtbl(M) 

locale, locale: The international .... locale(M) 
network, mmdf: routes mail locally and over any supported . . mmdf(ADM) 

tzset: Converts date and/ ctime, localtime, gmtime, asctime, . . . ctime(S) 

end, etext, edata: Last locations in program end(S) 

memory, lock: Locks a process in primary . lock(S) 
lock: Locks a user’s terminal. . . lock(C) 

memory, plock: Lock process, text, or data in . . . plock(S) 

record locking on files, lockf: Provide semaphores and . . lockf(S) 

region for reading or writing, locking: Locks or unlocks a file . . locking(S) 

Provide semaphores and record locking on files, lockf: lockf(S) 

memory, lock: Locks a process in primary . . . lock(S) 

lock: Locks a user’s terminal lock(C) 

for reading or/ locking: Locks or unlocks a file region . . locking(S) 
gamma: Performs log gamma function gamma(S) 
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exponential, logarithm,/ exp, log, pow, sqrt, log 10: Performs . . exp(S) 

logarithm,/ exp, log, pow, sqrt, loglO: Performs exponential, . . . exp(S) 

/log 10: Performs exponential, logarithm, power, square root/ . . exp(S) 

logs. MMDF logfiles logs(F) 

strelean: STREAMS error logger cleanup program strclean( ADM) 

strerr: STREAMS error logger daemon strerr(ADM) 

current SCSI hard disks /display logical SCSI ID numbers for . . . scsinfo(ADM) 

layer relogin: rename login entry to show current . . . relogin(ADM) 

password, passwd: Change login, group, or dialup shell . . . passwd(C) 

getlogin: Gets login name getlogin(S) 

logname: Gets login name logname(C) 

cuserid: Gets the login name of the user cuserid(S) 

logname: Finds login name of user logname(S) 

passwd: Changes login password passwd(C) 

terminal: Login terminal terminal(HW) 

inittab: Alternative login terminals file inittab(F) 

Sets up an environment at login time, profile: profile(M) 

last: Indicate last logins of users and teletypes . . . last(C) 

user, logname: Finds login name of . . logname(S) 

logname: Gets login name logname(C) 

logs: MMDF logfiles logs(F) 

idleout: Logs out idle users idleout(ADM) 

newgrp: Logs user into a new group. . . . newgrp(C) 

“goto”, setjmp, longjmp: Performs a nonlocal . . setjmp(S) 
for an object library, lorder: Finds ordering relation . . lorder(CP) 

Converts uppercase characters to lowercase, strlwr: strlwr(DOS) 

uppercase, strupr: Converts lowercase characters to stnipr(DOS) 

requests to lineprinter. Ip, cancel: Send/cancel lp(C) 

device interfaces. Ip, IpO, Ip 1, lp2: Line printer . . . Ip(HW) 
administer filters used with the LP print service Ipfilter: .... lpfilter(ADM) 

administer forms used with the LP print service Ipforms: .... Ipforms(ADM) 

utility Ipsh: Menu driven Ip print service administration . . Ipsh(ADM) 
device interfaces. Ip, IpO, Ipl, lp2: Line printer .... Ip(HW) 
interfaces. Ip, IpO, Ipl, lp2: Lineprinter device . . . Ip(HW) 

interfaces. Ip, IpO, Ipl, lp2: Line printer device Ip(HW) 

lineprinter spooling system. Ipadmin: Configures the Ipadmin(ADM) 

used with the LP print service Ipfilter: administer filters .... lpfilter(ADM) 
with the LP print service Ipforms: administer forms used . . Ipforms(ADM) 
maintains lineprinters. Ipinit: Adds, reconfigures and . . Ipinit(ADM) 

lineprinter/ Ipsched, Ipshut, Ipmove: Starts/stops the Ipsched(ADM) 

attached to the user’s terminal Iprint: Print to a printer Iprint(C) 

Starts/stops the lineprinter/ Ipsched, Ipshut, Ipmove: Ipsched(ADM) 

service administration utility Ipsh: Menu driven Ip print .... Ipsh(ADM) 

lineprinter request. Ipsched, Ipshut, Ipmove: Starts/stops the . . Ipsched(ADM) 

status information. Ipstat: prints lineprinter Ipstat(C) 

priorities Ipusers: set printing queue .... Ipusers(ADM) 

contents of directories. Is: Gives information about . . . ls(C) 

search and update. Isearch, Ifind: Performs linear . . Isearch(S) 

pointer. Iseek: Moves read/write file ... Iseek(S) 

characters. Itoa: Converts long integers to . . Itoa(DOS) 

integers and long/ 13tol, ltol3: Converts between 3-byte . . 13tol(S) 
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m4: Invokes a macro processor. . . m4(CP) 

type truth value machid: machid, 1386 - get processor . . . machid(C) 

processor type truth value machid: machid, 1386 - get .... machid(C) 

Machine: Description of host machine machine(HW) 

machine. Machine: Description of host . . . machine(HW) 
features/ intro: Introduction to machine related miscellaneous . . Intro(HW) 

sysi86: machine specific ftinctions. . . . sysi86(S) 

values: machine-dependent values .... values(M) 

Accesses long integer data in a machine-independent /sgetl: . . sputl(S) 

m4: Invokes a macro processor m4(CP) 

program, tape: Magnetic tape maintenance . . . tape(C) 
tapedump: Dumps magnetic tape to output file. . . . tapedump(C) 

Sends, reads or disposes of mail, mail: mail(C) 

binary file for transmission via mail uudecode: decode a .... uuencode(C) 
binary file for transmission via mail uuencode: encode a .... uuencode(C) 

msg:read mail msg(C) 

maildelivery: user mail delivery specification file . . maildelivery(F) 

deliver: MMDF mail delivery process deliver(ADM) 

submit: MMDF mailenqueuer submit(ADM) 

MMDF queue files for storing mail in transit queue: queue(ADM) 

supported network, mmdf: routes mail locally and over any .... mmdf(ADM) 
rmail: submit remote mail received via UUCP .... rmail(ADM) 

away rcvtrip: notifies mail sender that recipient is ... rcvtrip(C) 

of mail, mail: Sends, reads or disposes . . mail(C) 

but not/ checkmail: checks for mail which has been submitted . . checkmail(C) 

daemon.mn: Micnet mailer daemon daemon.mn(M) 

processing system mailx: interactive message .... mailx(C) 

free, realloc, calloc: Allocates main memory, malloc, malloc(S) 

fdisk: Maintain disk partitions fdisk(ADM) 

libraries, ar: Maintains archives and ar(CP) 

Ipinit: Adds, reconfigures and maintains lineprinters Ipinit(ADM) 

regenerates groups of/ make: Maintains, updates, and make(CP) 

systty: System maintenance device systty(M) 

tape: Magnetic tape maintenance program tape(C) 

hard disk device major/minor numbers /display . . hdutil(ADM) 

of major device numbers/ majorsinuse: displays the list . . . majorsinuse(ADM) 

key. makekey: Generates an encryption makekey(M) 

cref: Makes a cross-reference listing. . . cref(CP) 

execseg: makes a data region executable. . execseg(S) 
sees file, delta: Makes a delta (change) to an ... delta(CP) 

mkdir: Makes a directory mkdir(C) 

or ordinary file, mknod: Makes a directory, or a special . . mknod(S) 

In: Makes a link to a file ln(C) 

mktemp: Makes a unique filename mktemp(S) 

another user, su: Makes the user a super-user or . . su(C) 

Allocates main memory, malloc, free, realloc, calloc: . . . malloc(S) 

ev_init: Invokes the event manager. ev_init(S) 

shl: Shell layer manager. shl(C) 

tsearch, tfind, tdelete, tw^k: Manages binary search trees. . . . tsearch(S) 

hsearch, hcreate, hdestroy: Manages hash search tables. . . . hsearch(S) 

records fwtmp: fwtmp, wtmpfix: manipulate connect accounting . . fwtmp(ADM) 
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/floating-point number into a mantissa and an exponent frexp(S) 

ascii: Map of the ASCII character set. . . ascii(M) 

mapping, mapchan: Configure tty device . . mapchan(M) 

mapping files, mapchan: Format of tty device . . mapchan(F) 

convkey: Configure monitor/ mapkey, mapscm, mapstr, .... mapkey(M) 
Configure monitor screen mapping, /mapstr, convkey: . . . mapkey(M) 

mapchan: Configure tty device mapping mapchan(M) 

mapchan: Format of tty device mapping files mapchan(F) 

usemouse: Maps mouse input to keystrokes . usemouse(C) 
Configure monitor/ mapkey, mapscm, mapstr, convkey: .... mapkey(M) 
monitor screen/ mapkey, mapscm, mapstr, convkey: Configure . . . mapkey(M) 

Return the current event mask. ev_getemask: ev _gtemsk(S) 

Sets and gets file creation mask, umask: umask(S) 

ev_setemask: Sets event mask ev_stemsk(S) 

umask: Sets file-creation mode mask umask(Q 

assembler, masm: Invokes the XENIX . . . masm(CP) 

Regular expression compile and match routines, regexp: regexp(S) 

math: math functions and constants . . . math(M) 

constants math: math functions and .... math(M) 

function, matherr: Error-handling matherr(S) 

limit file, maxuuscheds: UUCP uusched . . maxuuscheds(F) 
limit file, maxuuxqts: UUCP uuxqt .... maxuuxqts(F) 
currently specified in the mdevice file /device numbers . . majorsinuse(ADM) 

mdevice: file format mdevice(F) 

mem, kmem: Memory image file. . mem(M) 

Lock process, text, or data in memory, plock: plock(S) 

lock: Locks a process in primary memory lock(S) 

queue, semaphore set or shared memory. /Removes a message . . ipcrm(ADM) 

realloc, calloc: Allocates main memory, malloc, free malloc(S) 

adjusted when adding more memory ^^arameters to be .... memtune(F) 

parameters to match system memory /adjust tunable idmemtune(ADM) 

mem, kmem: Memory image file mem(M) 

shmctl: Controls shared memory operations shmctl(S) 

shmop: Performs shared memory operations shmop(S) 

shmget: Gets a shared memory segment shmget(S) 

Reports virtual memory statistics, vmstat: .... vmstat(C) 
administration/ atcronsh: Menu driven at and cron .... atcronsh(ADM) 
utility auditsh: Menu driven audit administration . auditsh(ADM) 

administration/ backupsh: Menu driven backup backupsh(ADM) 

administration utility Ipsh: Menu driven Ip print service . . . Ipsh(ADM) 

administration/ sysadmsh: Menu driven system sysadmsh(ADM) 

files acctmerg: merge or add total accounting . . acctmerg(ADM) 

sort: Sorts and merges files sort(C) 

paste: Merges lines of files paste(C) 

sent to a terminal, mesg: Permits or denies messages . mesg(C) 
msgctl: Provides message control operations. . . . msgctl(S) 

mkstr: Creates an error message file from C source. . . . mkstr(CP) 

msgop: Message operations msgop(S) 

mailx: interactive message processing system . . . mailx(Q 

msgget: Gets message queue msgget(S) 

shared memory, ipcrm: Removes a message queue, semaphore set or . ipcrm(ADM) 
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hello: Send a 
Description of system console 
Prints STREAMS trace 
dosexterr: Gets DOS error 
ermo: Sends system error 
console messages, 
mestbl: create a 
mesg: Permits or denies 
file 

(F) 

micnet: The 
daemon.mn: 
mnlist: converts a XENIX-style 
file, systemid: The 
commands file, 
top, top.next: The 
vdutil: rebuild a 
vdutil: repair bad block on a 
vdutil: restart I/O on a 
add.vd: add a 
del.vd: delete a 
/- overview of accounting and 
Antroduction to machine related 
files, intro: Introduction to 



special or ordinary file, 
file from C source. 

list: list processor channel for 
program checkaddr: 
/Micnet routing file to 
/UUCP routing file to 
XENIX-style aliases file to 
alias and/ dbmbuild: builds the 
logs: 
deliver: 
submit: 
tables: 

mail in transit queue: 
generator checkque: 
over any supported network, 
aliases file to MMDF/ 
Micnet routing file to/ 

system table, 
setmode: Sets translation 
sulogin: access single-user 



message to another user. . . . . 

messages, messages: 

messages strace: 

messages 

messages. /sys_nerr, 

messages: Description of system 

messages locale file 

messages sent to a terminal. . . . 
mestbl: create a messages locale 

mfsys: file format 

mfsys: file format 

Micnet default commands file. . . 

Micnet mailer daemon 

Micnet routing file to/ 

Micnet system identification . . . 
micnet: The Micnet default . . . 

Micnet topology files 

mirrored disk 

mirrored disk 

mirrored disk 

mirrored (virtual) disk 

mirrored (virtual) disk 

miscellaneous accounting/ .... 
miscellaneous features and/ . . . 

miscellaneous features and ... 

mkdir: Creates a new directory. . . 

mkdir: Makes a directory 

mkfs: Constructs a file system. . . 
mknod: Builds special files. . . . 
mknod: Makes a directory, or a . . 
mkstr: Creates an error message 
mktemp: Makes a unique filename. 

MMDF 

MMDF address verification . . . 

MMDF format 

MMDF format 

MMDF format, /converts . . . . 
MMDF hashed database of .... 

MMDFlogfiles 

MMDF mail delivery process . . 

MMDF mail enqueuer 

MMDF Name Tables 

MMDF queue files for storing . . 
MMDF queue status report . . . 
mmdf: routes mail locally and . . 
mmdfalias: converts XENIX-style . 
mnlist: converts a XENIX-style . . 

mnt: Mount a filesystem 

mnttab: Format of mounted file . . 

mode 

mode 



heUo(ADM) 

messages(M) 

strace(ADM) 

dosexter(DOS) 

perror(S) 

messages(M) 

mestbl(M) 

mesg(C) 

mestbl(M) 

mfsys(F) 

mfsys 

micnet(F) 

daemon.mn(M) 

mnlist(ADM) 

systemid(F) 

micnet(F) 

top(F) 

vdutil(ADM) 

vdutil(ADM) 

vdutil(ADM) 

add.vd(ADM) 

del.vd(ADM) 

acct(ADM) 

Intro(HW) 

Intro(M) 

mkdir(DOS) 

mkdir(C) 

mkfs(ADM) 

mknod(C) 

mknod(S) 

mkstr(CP) 

mktemp(S) 

list(ADM) 

checkaddr(ADM) 

mnlist(ADM) 

uulist(ADM) 

mmdfalias(ADM) 

dbmbuild(ADM) 

logs(F) 

deliver(ADM) 

submit(ADM) 

tables(F) 

queue(ADM) 

checkque(ADivl) 

mmdf(ADM) 

mmdfalias(ADM) 

mnlist(ADM) 

mnt(C) 

mnttab(F) 

setmode(DOS) 

sulogin(ADM) 
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vidi: Sets the font and video mode for a video device vidi(C) 

umask: Sets file-creation mode mask umask(C) 

chmod: Changes mode of a file chmod(S) 

kbmode; Set keyboard mode or test keyboard support . . kbmode(ADM) 

dial: Dials a modem dial(ADM) 

peu: modem port configuration .... pcu(ADM) 

uuchat: dials a modem dial(ADM) 

xpreat: transparent printer over modem line command xprcat(C) 

tset: Sets terminal modes tset(Q 

setmode: port modes utility setmode(C) 

getty: Sets terminal type, modes, speed, and line/ getty(M) 

uugetty: set terminal type, modes, speed, and line/ uugetty(ADM) 

number into a/ frexp, Idexp, modf: Splits floating-point .... frexp(S) 

settime: Changes the access and modification dates of files settime(ADM) 

utime: Sets file access and modification times utime(S) 

touch: Updates access and modification times of a file. . . . touch(C) 

/produces a list of the software modifications to the system . . . swconfig(C) 

entry points in a driver object module, routines: finds driver . . routines(ADM) 

Relocatable Format for Object Modules. 86rel: Intel 8086 . . . 86rel(F) 

/ckpacct, dodisk, lasdogin, monacct, nulladm, pretmpy . . . acctsh(ADM) 

profile, monitor: Prepares execution . . . monitor(S) 

/mapstr, convkey: Configure monitor screen mapping mapkey(M) 

uusub: Monitor UUCP network uusub(C) 

tty [01-rt], color, monochrome, ega,. screen: . . . screen(HW) 

mnt: Mount a filesystem mnt(C) 

fstab: File system mount and check commands. . . . fstab(F) 

mount: Mounts a file structure. . . mount(ADM) 

mount: Mounts a file system. . . . mount(S) 
mountall: mountall, umountall - mount, unmount multiple file/ . . mountall(ADM) 

mountall: mountall, umountall mount, unmount multiple file/ . . mountall(ADM) 

mount, unmount multiple file/ mountall: mountall, umountall - . . mountall(ADM) 

unmount multiple file/ mountall: mountall, umountall - mount, . . . mountall(ADM) 

mnttab: Format of mounted file system table mnttab(F) 

/Default information for mounting filesystems filesys(F) 

mount: Mounts a file structure mount(ADM) 

mount: Mounts a file system mount(S) 

mouse: System mouse mouse(HW) 

usemouse: Maps mouse input to keystrokes .... usemouse(C) 

mouse: System mouse mouse(HW) 

specific address, movedata: Copies bytes from a . . movedata(DOS) 

mvdir: Moves a directory mvdir(C) 

directories, mv: Moves or renames files and . . . mv(C) 

Iseek: Moves read/write file pointer. . . Iseek(S) 

utility mscieen: Serial multiscreens . . . mscreen(M) 

dosld: XENIX to MS-DOS cross linker dosld(CP) 

msg: read mail nisg(C) 

operations, msgctl: Provides message control . msgctl(S) 

msgget: Gets message queue. . . . msgget(S) 

msgop: Message operations. . . . msgop(S) 

mtune: file format mtune(F) 

umountall - mount, unmount multiple file systems /mountall, . mountall(ADM) 
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used by X t (7)/ xtproto: multiplexed channels protocol . . xtproto(M) 

windowing terminals xt: multiplexed tty driver for AT&T . xt(HW) 

terminals layers: layer multiplexer for windowing .... layers(C) 

select: synchronous I/O multiplexing select(S) 

mscreen: Serial multiscreens utility mscreen(M) 

rc2: run commands performed for multiuser environment rc2(ADM) 

directories, mv: Moves or renames files and . . mv(C) 

mvdir: Moves a directory mvdir(C) 

Gets value for environment name, getenv: getenv(S) 

devnm: Identifies device name devnm(C) 

getlogin: Gets login name getlogin(S) 

logname: Gets login name logname(C) 

pwd: Prints working directory name pwd(C) 

tty: Gets the terminal’s name tty(C) 

Prints user and group IDs and names, id: id(C) 

user and group IDs and names id: print id(ADM) 

specific hard disk device names /display and remove . . . hdutil(ADM) 

ncheck: Generates names from inode numbers. . . . ncheck(ADM) 

basename: Removes directory names from pathnames basename(C) 

archive, dumpdir: Prints the names of files on a backup .... dumpdir(C) 

short interval, nap: Suspends execution for a . . nap(S) 

access to a resource/ waitsem, nbwaitsem: Awaits and checks . . waitsem(S) 

inode numbers, ncheck: Generates names from . . ncheck(ADM) 

network, netutil: Administers the XENIX . . netutil(ADM) 

locally and over any supported netwoilc, mmdf: routes mail . . . mmdf(ADM) 

netutil: Administers the XENIX network netutil(ADM) 

uusub: Monitor uucp network uusub(C) 

administration nlsadmin: network listener service nlsadmin(ADM) 

/configuration interface for networking products strmtune: . . strmtune(ADM) 

/configuration utility for networking products strmcfg: . . strmcfg(ADM) 

XENIX-style/ addxusers: add new user accounts given a . . . . addxusers(ADM) 

text file, newform: Changes the format of a . newform(C) 

group, newgrp: Logs user into a new . . newgrp(C) 

news: Print news items news(C) 

news: Print news items news(C) 

/fetch, store, delete, firstkey, nextkey: Performs database/ . . . dbm(S) 

tables nictable: process NIC database into channel/domain nictable(ADM) 
process, nice: Changes priority of a .... nice(S) 

different priority, nice: Runs a command at a ... nice(C) 

into channel/domain tables nictable: process NIC database . . nictable(ADM) 

nl: Adds line numbers to a file. . . nl(C) 

list, nlist: Gets entries from name . . . nlist(S) 

service administration nlsadmin: network listener .... nlsadmin(ADM) 

nm: Prints name list nm(CP) 

hangups and quits, nohup: Runs a command immune to nohup(C) 

setjmp, longjmp: Performs a nonlocal “goto” setjmp(S) 

goodpw: Check a password for non-obviousness goodpw(ADM) 

false: Returns with a nonzero exit value false(C) 

is away rcvtrip: notifies mail sender that recipient . rcvtrip(C) 

Terminal driving tables for nrofif. term: term(F) 

null: The null file nuU(F) 
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null: The null file nuU(F) 

/dodisk, lastlogin, monacct, nulladm, prctmp, prdailyy .... acctsh(ADM) 

a string to a double-precision number, strtod, atof: Converts . . strtod(S) 

factor: Factor a number factor(C) 

rand, srand: Generates a random number. rand(S) 

random: Generates a random number. random(C) 

Generates names from inode numbers, ncheck: ncheck(ADM) 

atoi, atol: Converts ASCII to numbers, atof, atof(S) 

hard disk device major/minor numbers Alisplay hdutil(ADM) 

library routines and error numbers. System services, . . . Intro(S) 

the/ /the list of major device numbers currently specified in . . majorsinuse(ADM) 

nl: Adds line numbers to a file nl(Q 

ultoa: Converts numbers to characters ultoa(DOS) 

itoa: Converts numbers to integers itoa(DOS) 

numtbl: Create a numeric locale table numtbl(M) 

table, numtbl: Create a numeric locale . numtbl(M) 

DMD terminal wtinit: object do wnloader for the 5620 . . wtinit(ADM) 

information for a common object file reloc: relocation . . . reloc(F) 

line number entries in a common object file linenum: linenum(F) 

section header for a common object file scnhdr: scnhdr(F) 

size: Prints the size of an object file size(CP) 

the printable strings in an object file, strings: Finds .... strings(CP) 

Idfcn: common object file access routines .... ldfcn(F) 

syms: common object file symbol table format . . syms(F) 

filehdr: file header for common object files filehdr(F) 

Finds ordering relation for an object library, lorder: lorder(CP) 

driver entry points in a driver object module, routines: finds . . routines(ADM) 

8086 Relocatable Format for Object Modules. 86rel: Intel . . . 86rel(F) 

a process until a signal occurs, pause: Suspends .... pause(S) 

od: Displays files in octal format od(C) 

format, od: Displays files in octal .... od(C) 

Invokes a restricted version of. red: red(C) 

fp_off, fp_seg: Return ofiset and segment fp_seg(DOS) 

new file or rewrites an existing one. creat: Creates a creat(S) 

and writing, sopen: Opens a file for shared reading . . sopen(DOS) 

opensem: Opens a semaphore opensem(S) 

fopen, freopen, fdopen: Opens a stream fopen(S) 

ev_open: Opens an event queue for input. . . ev_open(S) 

writing, open: Opens file for reading or open(S) 

opensem: Opens a semaphore. . . opensem(S) 
commands performed to stop the operating system rcO: run .... rcO(ADM) 
prf: operating system profiler .... prf(HW) 

closedir: Performs directory operations directory(S) 

msgctl: Provides message control operations msgctl(S) 

msgop: Message operations msgop(S) 

semctl: Controls semaphore operations semcU(S) 

semop: Performs semaphore operations semop(S) 

shmctl: Controls shared memory operations shmctl(S) 

shmop: Performs shared memory operations shmop(S) 

strdup: Performs string operations string(S) 

UNIX filesystems for optimal access time dcopy: copy . dcopy(ADM) 
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vector, getopt: Gets 
fcntl: file control 
getopt: Parses command 
getoptcvt - parse command 
stty: Sets the 
library, lorder: Finds 
a directory, or a special or 
Otar: 

Copies file archives in and 
dial: Establishes an 
port. 

buffered binary input and 
cprintf: Formats 
fprintf, sprintf: Formats 
of assembler and link editor 
pr: Prints files on the standard 
standard buffered input and 
flushall: Flushes all 
ecvt, fcvt, gcvt: Performs 
error: Kernel error 
tapedump: Dumps magnetic tape to 
/vsprintf: Prints formatted 
outp: Writes a byte to an 
parameters sysdef: 
/acctdusg, accton, acctwtmp - 
/acctdusg, accton, acctwtmp 
purge: 

chown: Changes the 
chown: Changes 
quot: Summarizes file system 
and expands files, 
installpkg: install 
interprocess communication 
removepkg: remove installed 
sadc - system activity report 
displaypkg: display installed 
xtt: extract and print xt driver 
terminal 4014: 
to set value of a tunable 
strmcfg: calculate STREAMS 
sysdef: output values of tunable 
system/ /adjusts tunable 
when adding more memory 
Gets process, process group, and 
getopts: getopts, getoptcvt - 
getopts: getopts, getoptcvt 
getopt: 
fdisk: Maintain disk 
files, hdr: Displays selected 
dialup shell password. 



option letter from argument . . . 

options 

options 

options getopts: getopts, .... 

options for a terminal 

ordering relation for an object . . 
ordinary file, mknod: Makes . . . 
original tape archive command . . 

out. cpio: 

out-going terminal line/ 

outp: Writes a byte to an output . . 
output, fread, fwrite: Performs . . 

output 

output printf, 

output a.out: Format 

output 

output, stdio: Performs 

output buffers 

output conversions 

output device 

output file 

output of a varargs/ 

output port 

output values of tunable 

overview of accounting and/ . . . 
overview of accounting and/ ... 
overwrites specified files . . . . 

owner and group of a file 

owner ID 

ownership 

pack, peat, unpack: Compresses 

package 

package, ftok: Standard 

package 

package sar: sar, sal, sa2, .... 

packages 

packet traces 

paginator for the TEKTRONIX 4014 
parameter idtune: attempts . . . 

parameter values 

parameters 

parameters to match 

paramters to be adjusted . . . . 
parent process IDs. /getppid: . . . 

parse command options ..... 

parse command options 

Parses command options 

partitions. 

parts of executable binary .... 
passwd: Change login, group, or 
passwd: The password file. . . . 



getopt(S) 

fcnti(M) 

getopt(Q 

getopts(C) 

stty(C) 

lorder(CP) 

mknod(S) 

otar(C) 

cpio(C) 

dial(S) 

outp(DOS) 

fread(S) 

cprintf(DOS) 

printf(S) 

a.out(F) 

pr(C) 

stdio(S) 

flushall(DOS) 

ecvt(S) 

error(M) 

tapedump(C) 

vprintf(S) 

outp(DOS) 

sysdef(ADM) 

acct(ADM) 

acct(ADM) 

puiBe(C) 

chown(S) 

chown(C) 

quot(C) 

pack(C) 

installpkg(ADM) 

stdipc(S) 

removepkg(ADM) 

sar(ADM) 

displaypkg(ADM) 

xtt(ADM) 

4014(C) 

idtune(ADM) 

strmcfg(ADM) 

sysdef(ADM) 

idmemtune(ADM) 

memtune(F) 

getpid(S) 

getopts(C) 

getopts(C) 

getopt(C) 

fdisk(ADM) 

hdr(CP) 

passwd(C) 

passwd(F) 
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gelpass: Reads a password getpass(S) 

login, group, or dialup shell password, passwd: Change . . . passwd(C) 

passwd: The password file passwd(F) 

pwcheck: Checks password file pwcheck(C) 

new user accounts given a/ password file addxusers: add . . . addxusers(ADM) 

putpwent: Writes a password file entry putpwent(S) 

sctpwent, endpwent: Gets password file entry, /getpwnam, . getpwent(S) 

getpw: Gets password for a given user ID. ... getpw(S) 

goodpw: Check a password for non-obviousness. . . goodpw(ADM) 

paste: Merges lines of files. . . . paste(C) 

Delivers directory part of pathname, dimame: dimame(C) 

directory, getcwd: Get the pathname of current working . . . getcwd(S) 

Removes directory names from pathnames, basename: basename(C) 

fgrep: Searches a file for a pattern, grep, egrep grep(0 

Searches for and processes a pattern in a file, awk: awk(C) 

a signal occurs, pause: Suspends a process until . . pause(S) 

pax: portable archive exchange . . pax(C) 

keyboard: The PC keyboard keyboard(HW) 

expands files, pack, peat, unpack: Compresses and . . pack(C) 

a process, popen, pclose: Initiates I/O to or from . . popen(S) 

reduction reduce: perform audit data analysis and . . reduce(ADM) 

environment rc2: run commands performed for multiuser ..... rc2(ADM) 

system rcO: run commands performed to stop the operating . . rcO(ADM) 

bsearch: Performs a binary search bsearch(S) 

setjmp, longjmp: Performs a nonlocal “goto”. . . . setjmp(S) 

qsort: Fferforms a quicker sort qsort(S) 

floor, fabs, ceil, fmod: Performs absolute value, floor,/ . . floor(S) 

bessel, jO, j 1 , jn, yO, y 1 , yn: Performs Bessel functions bessel(S) 

and output, fread, fwrite: Performs buffered binary input . . fread(S) 

/delete, firstkey, nextkey: Performs database functions. . . . dbm(S) 

closedir: Performs directory operations. . . directory(S) 
exp, log, pow, sqrt, log 10; Performs exponential, logarithm,/ . exp(S) 
sinh, cosh, tanh: Performs hyperbolic functions. . . sinh(S) 
backup, backup: Performs incremental file system . backup(ADM) 
update. Isearch, Ifind: Performs linear search and .... Isearch(S) 
gamma: I^rforms log gamma function. . . gamma(S) 
ecvt, fevt, gevt: Performs output conversions. . . . ecvt(S) 

system backups fsphoto: Performs periodic semi-automated . fsphoto(ADM) 

functions backup: performs UNIX backup backup(ADM) 

incremental filesystem/ xbackup: Performs XENIX xbackup(ADM) 

functions, curses: Performs screen and cursor . . . curses(S) 

semop: Performs semaphore operations. . semop(S) 
operations, shmop: Performs shared memory .... shmop(S) 
and output, stdio; Performs standard buffered input . stdio(S) 
strdup: Fbrforms string operations. .... string(S) 
/tgetflag, tgetstr, tgoto, tputs: Performs terminal functions. . . . termcap(S) 

tan, asin, acos, atan, atan2: Performs trigonometric/ /cos, . . trig(S) 

backups fsphoto: Performs periodic semi-automated system . fsphoto(ADM) 

check the uucp directories and permissions file uucheck: .... uucheck(ADM) 

permissions: Format of UUCP Permissions file permissions(F) 

Permissions file, permissions: Format of UUCP . . permissions(F) 
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chmod: Changes the access permissions of a file or/ chmod(C) 

to a terminal, mesg: Permits or denies messages sent . mesg(C) 

acct: Format of per-process accounting file. . . . acct(F) 

acctcms: command summary from per-process accounting records . . acctcms(ADM) 

ermo: Sends system error/ perror, sys_errlist, sys_nerr, . . . perror(S) 

split: Splits a file into pieces split(C) 

pipe: Creates an interprocess pipe pipe(S) 

tee: Creates a tee in a pipe tee(C) 

pipe, pipe: Creates an interprocess . . . pipe(S) 
data in memory, plock: Lock process, text, or ... plock(S) 

plot: graphics interface plot(F) 

images pnch: file format for card .... pnch(F) 

Iseek: Moves read/write file pointer Iseek(S) 

the current position of the file pointer, tell: Gets tell(DOS) 

rewind: Repositions a file pointer in a stream, /ftell, .... fseek(S) 

routines: finds driver entry points in a driver object/ routines(ADM) 

utility purge(C) purge: the policy file of the sanitization . . . purge(F) 

poll: Format of UUCP R)llfile poU(F) 

poll: Format of UUCP Poll file. . * poU(F) 
queue. ev_pop: Pop the next event off the .... ev_pop(S) 
or from a process, popen, pclose: Initiates I/O to . . popen(S) 

outp: Writes a byte to an output port outp(DOS) 

pcu: port configuration utility .... pcu(ADM) 

setmode: port modes utility setmode(C) 

pax: portable archive exchange .... pax(C) 

tty2[A-H]: Interface to serial ports. /, tty l[A-H],tty2[a-h], . . . serial(HW) 

pscat: ASCII-to- PostScript filter pscat(C) 

exponential^ exp, log, pow, sqrt, loglO: Performs .... exp(S) 
powerfail: performs power failure shutdown service . powerfail(M) 
restart: performs power failure recovery service . . restart(M) 

/Performs exponential, logarithm, power, square root functions. . . . exp(S) 
output, pr: Prints files on the standard . . pr(C) 

Aastlogin, monacct, nulladm, prctmp, prdaily, prtaccty .... acctsh(ADM) 
Anonacct, nulladm, prctmp, prdaily, prtacct, runaccty .... acctsh(ADM) 

dc: Invokes an arbitrary precision calculator dc(C) 

monitor: Prepares execution profile monitor(S) 

cpp: The C language preprocessor cpp(CP) 

unget: Undoes a previous get of an SCCS file. . . . unget(CP) 

prf: operating system profiler . . . prf(HW) 

profiler: prfld, prfstat, prfdc, prfsnap, prfjpr -/ profiler(ADM) 

prfpr-UNIX/ profiler: prfld, prfstat, prfdc, prfsnap, . . . profiler(ADM) 

^rfld, prfstat, prfdc, prfsnap, prfpr - UNIX system/ profiler(ADM) 

profiler: prfld, prfstat, prfdc, prfsnap, prfpr - UNIX/ profiler(ADM) 

-/ profiler: prfld, prfstat, prfdc, prfsnap, prfpr . . . profiler(ADM) 

lock: Locks a process in primary memory lock(S) 

graphical files gps: graphical primitive string, format of .... gps(F) 
types: Primitive system data types. . . . types(F) 

temporarily privs: print and/or restrict privileges . . privs(C) 

to a serial/ consoleprint: Print file to printer attached . . . consoleprint(ADM) 

news: Print news items news(C) 

infocmp: compare or print out terminfo descriptions . . infocmp(ADM) 
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filters used with the LP print service /administer .... lpfilter(ADM) 
forms used with the LP print service /administer .... Ipforms(ADM) 
utility Ipsh: Menu driven Ip print service administration . . . Ipsh(ADM) 

jwin: print size of layer jwin(Q 

the user’s terminal Iprint: Print to a printer attached to ... Iprint(C) 

hostid: print unique hardware ID .... hostid(ADM) 

and names id: print user and group IDs id(ADM) 

xtt: extract and print xt driver packet traces . . . xtt( ADM) 

xts: extract and print xt driver statistics xts(ADM) 

file, strings: Finds the printable strings in an object . . . strings(CP) 

Prints text files on an IMAGEN printer, imprint: imprint(C) 

pcu: printer port configuration .... pcu(ADM) 

xprsetup: transparent printer setup utility xprsetup(ADM) 

command xprcat: transparent printer over modem line .... xprcat(C) 

consoleprint: Print file to printer attached to a serial/ .... consoleprint(ADM) 
terminal Iprint: Print to a printer attached to the user’s . . . Iprint(C) 

Ip, IpO, Ipl , lp2: Line printer device interfaces Ip(HW) 

xprtab: system tty transparent printer map file xprtab(F) 

T\ims on terminals and line printers, enable: enable(C) 

disable: Turns off terminals and printers disable(C) 

Formats output, printf, fprintf, sprintf: printf(S) 

Ipusers: set printing queue priorities Ipusers(ADM) 

cal: Prints a calendar cal(C) 

prs: Prints an SCCS file prs(CP) 

sddate: Prints and sets backup dates. . . . sddate(C) 

date: Prints and sets the date date(C) 

activity, sact: Prints current SCCS file editing . . sact(CP) 

output, pr: Prints files on the standard .... pr(C) 

vprintf, vfprintf, vsprintf: Prints formatted output of a/ . . . vprintf(S) 

banner: Prints large letters banner(C) 

information. Ipstat: prints lineprinter status Ipstat(C) 

nm: Prints name list nm(CP) 

file system fsname: Prints or changes the name of a . . fsname(ADM) 

acctcom: Searches for and prints process accounting files. . . acctcom(ADM) 

messages strace: Prints STREAMS trace strace(ADM) 

yes: Prints string repeatedly yes(C) 

printer, imprint: Prints text files on an IMAGEN . . imprint(C) 
stream, head: Prints the first few lines of a ... head(Q 
UNIX system, uname: Prints the name of the current . . uname(C) 
backup archive, dumpdir: Prints the names of files on a ... dumpdir(C) 
file, size: Prints the size of an object .... size(CP) 
names, id: Prints user and group IDs and . . id(C) 

pwd: Prints working directory name. . . pwd(C) 

Ipusers: set printing queue priorities Ipusers(ADM) 

Runs a command at a different priority, nice: nice(C) 

nice: Changes priority of a process nice(S) 

privs: print and/or restrict privileges temporarily privs(C) 

privileges temporarily privs: print and/or restrict .... privs(C) 

- system initialization procedures brc: brc, bcheckrc . . brc(ADM) 

/startup, tumacct - shell procedures for accounting .... acctsh(ADM) 

Initiates I/O to or from a process, popen, pclose: popen(S) 
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deliver: MMDF mail delivery process deliver(ADM) 

exit, _exit: Terminates a process exit(S) 

exit: Terminates the calling process. exit(DOS) 

fork: Creates a new process fork(S) 

kill: Terminates a process kill(C) 

nice: Changes priority of a process nice(S) 

ptrace: Traces a process ptrace(S) 

spawnl, spawnvp: Creates a new process spawn(DOS) 

acct: Enables or disables process accounting acct(S) 

acctprc: acctprcl, acctprc2 - process accounting acctprc(ADM) 

acctprc: acctprcl, acctprc2 process accounting acctprc(ADM) 

acctcom: Searches for and prints process accounting files acctcom(ADM) 

alarm: Sets a process* alarm clock. ...... alarm(S) 

times: Gets process and child process times. . times(S) 
init, inir: Process control initialization. . . . init(M) 
timex: time a command; report process data and system activity . timex(ADM) 
/getpgrp, getppid: Gets process, process group, and parent/ .... getpid(S) 

setpgip: Sets process group ID setpgrp(S) 

process group, and parent process IDs. /Gets process, . . . getpid(S) 

lock: Locks a process in primary memory. . . . lock(S) 

channel/domain tables nictable: process NIC database into .... nictable(ADM) 
kill: Sends a signal to a process or a group of processes. . . kiU(S) 
getpid, getpgrp, getppid: Gets process, process group, and/ . . . getpid(S) 

ps: Reports process status ps(C) 

memory. plock:Lock process, text, or data in plock(S) 

times: Gets process and child process times times(S) 

wait: Waits for a child process to stop or terminate. . . . wait(S) 

pause: Suspends a process until a signal occurs. . . . pause(S) 

sigsem: Signals a process waiting on a semaphore. . sigsem(S) 

checklist: List of file systems processed by fsck checklist(F) 

Awaits completion of background processes, wait: wait(C) 

kiUall: kill all active processes killall(ADM) 

to a process or a group of processes, kill: Sends a signal . . kill(S) 
awk: Searches for and processes a pattern in a file. . . . awk(C) 

shutdown: Terminates all processing shutdown(ADM) 

mailx: interactive message processing system mailx(C) 

m4: Invokes a macro processor. m4(CP) 

list: list processor channel for MMDF . . list(ADM) 
machid: machid, i386 - get processor type truth value .... machid(C) 
subsystem events dlvr_audit: produce audit records for .... dlvr_audit(ADM) 
modifications to the/ swconfig: produces a list of the software . . swconfig(C) 

prof: Displays profile data prof(CP) 

prof: profile within a function . . prof(M) 
time profile, profil: Creates an execution . . . profil(S) 

Creates an execution time profile, profil: profil(S) 

monitor: Prepares execution profile monitor(S) 

prof: Displays profile data prof(CP) 

at login time, profile: Sets up an environment . . profile(M) 

prof: profile within a function prof(M) 

prf: operating system profiler prf(HW) 

prfpr - UNIX system profiler ^rfdc, prfsnap, profiler(ADM) 
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prfsnap, pifpr - UNIX/ profiler: prfld, prfstat, prfdc, . . . profiler(ADM) 

assert: Helps verify validity of program assert(S) 

boot: XENIX boot program boot(HW) 

ctext, edata: Last locations in program, end, end(S) 

tape: Magnetic tape maintenance program tape(C) 

ksh: standard command and programming language ksh(Q 

rksh: restricted command and programming language ksh(Q 

and regenerates groups of programs. /Maintains, updates, . . make(CP) 

cb: Beautifies C programs cb(CP) 

xref: Cross-references C programs xref(CP) 

xstr: Extracts strings from C programs xstr(CP) 

lex: Generates programs for lexical analysis. . . lex(CP) 

domain of a program promain: restrict the execution . . promain(M) 

day. asktime: Prompts for the correct time of . . asktime(ADM) 

proto: prototype job file for at . . proto(ADM) 

windowing terminal/ layers: protocol used between host and . . layers(M) 

xtproto: multiplexed channels protocol used by x t (7)/ .... xtproto(M) 

proto: prototype job file for at proto(ADM) 

labelit: provide labels for file systems . . labelit(ADM) 

locking on files, lockf: Provide semaphores and record . . lockf(S) 

operations, msged: Provides message control .... msgctl(S) 

prs: Prints an SCCS file prs(CP) 

Aiulladm, pretmp, prdaily, prtacct, runacct, shutacct,/ .... acctsh(ADM) 

ps: Reports process status ps(C) 

sxt: Pseudo-device driver sxt(M) 

information, pstat: Reports system pstat(C) 

ptrace: Traces a process ptrace(S) 

files purge: overwrites specified . . . purge(C) 

sanitization utility purge(C) purge: the policy file of the ... purge(F) 
file of the sanitization utility purge(C) purge: the policy . . . purge(F) 

stream, ungetc: Pushes character back into input . ungetc(S) 

a character or word on a/ putc, putchar, fputc, putw: Puts . . putc(S) 

console, putch: Writes a character to the . . putch(DOS) 

character or word on a/ putc, putchar, fputc, putw: Puts a ... putc(S) 

environment, putenv: Changes or adds value to . putenv(S) 

entry, putpwent: Writes a password file . putpwent(S) 

putc, putchar, fputc, putw: Puts a character or word on a/ . . putc(S) 

puts, fjputs: Puts a string on a stream puts(S) 

eputs: Puts a string to the console. . . . cputs(DOS) 

stream, puts, ^uts: Puts a string on a ... puts(S) 

on a/ putc, putchar, fputc, putw: Puts a character or word . . putc(S) 

pwcheck: Checks password file. . pwcheck(C) 
name, pwd: Prints working directory . . pwd(C) 

tapecntl: AT&T tape control for QIC-24/QIC-02 tape device . . . tapecntl(C) 

qsort: Performs a quicker sort, . . qsort(S) 

tput: Queries the terminfo database. . . tput(C) 

Pop the next event off the queue. ev_pop: ev_pop(S) 

Read the next event in the queue. ev_read: ev_iead(S) 

all events currently in the queue. ev_flush: Discard .... ev_flush(S) 

ev_resume: Restart a suspended queue ev_resume(S) 

ev_suspend: Suspends an event queue ev_susp(S) 
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list of devices feeding an event queue. ev_getdev: Gets a .... ev_getdev(S) 

msgget: Gets message queue msgget(S) 

of events currently in the queue. /Returns the number . . . ev_count(S) 

ev_close: Close the event queue and all associated/ .... ev_close(S) 

ev_block: Wait until the queue contains an event ev_Wock(S) 

transit queue: MMDF queue files for storing mail in . . . queue(ADM) 

ev_open: Opens an event queue for input ev_open(S) 

storing mail in transit queue: MMDF queue files for . . queue(ADM) 

Ipusers: set printing queue priorities Ipusers(ADM) 

ipcrm: Removes a message queue, semaphore set or shared/ . ipcrm(ADM) 

checkque: MMDF queue status report generator . . . checkque(ADM) 

qsort: Performs a quicker sort qsort(S) 

a command immune to hangups and quits, nohup: Runs nohup(C) 

ownership, quot: Summarizes file system . . . quot(C) 
number, rand, srand: Generates a random . rand(S) 
number, random: Generates a random . . . random(C) 

ranlib: Converts archives to random libraries ranlib(CP) 

rand, srand: Generates a random number rand(S) 

random: Generates a random number. random(C) 

random libraries, ranlib: Converts archives to ... ranlib(CP) 
FORTRAN into standard FORTRAN, ratfor: Converts Rational .... ratfor(CP) 
FORTRAN, ratfor: Converts Rational FORTRAN into standard . ratfor(CP) 
stop the operating system rcO: run commands performed to . rcO(ADM) 
multiuser environment rc2: run commands performed for . rc2(ADM) 
systems, rep: Copies files across XENIX . . rcp(C) 
data to be read, rdchk: Checks to see if there is . . rdchk(S) 

to see if there is data to be read, rdchk: Checks rdchk(S) 

generated by the audit/ auditd: read audit collection files .... auditd(ADM) 
in a file, getdents: read directory entries and put . . . getdents(S) 

specifications idmkinit: read files containing idmkinit(ADM) 

setlocale: Set or read international environment . . setlocale(S) 

msg: read mail msg(C) 

read: Reads from a file read(S) 

information, hwconfig: Read the configuration hwconfig(ADM) 

queue. ev_read: Read the next event in the .... ev_read(S) 

sopen: Opens a file for shared reading and writing sopen(DOS) 

open: Opens file for reading or writing open(S) 

or unlocks a file region for reading or writing. /Locks .... locking(S) 

getpass: Reads a password getpass(S) 

defopen, defread: Reads default entries defopen(S) 

read: Reads from a file read(S) 

line: Reads one line. line(C) 

mail: Sends, reads or disposes of mail mail(C) 

Iseek: Moves read/write file pointer Iseek(S) 

memory, malloc, free, realloc, calloc: Allocates main . . malloc(S) 

getclk: gets string from real-time clock getclk(M) 

clock: The system real-time (time of day) clock. . . . clock(F) 
setclock: Sets the system real-time (time of day) clock. . . . setclock(ADM) 
systems and shuts down/ haltsys, reboot: Closes out the file .... haltsys(ADM) 

vdutil: rebuild a mirrored disk vdutil(ADM) 

Specifies what to do upon receipt of a signal, signal: .... signal(S) 
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rmail: submit remote mail 
lineprinters. Ipinit: Adds, 
lockf: Provide semaphores and 
from per-process accounting 
manipulate connect accounting 
dlvr_audit: produce audit 
performs power failure 
version of. 
analysis and reduction 
perfonn audit data analysis and 
regular expressions, regex, 
expressions, 
make: Maintains, updates, and 
executes regular expressions, 
compile and match routines, 
execseg: makes a data 
locking: Locks or unlocks a file 
match routines, regexp: 
regcmp: Compiles and executes 
regcmp: Compiles 
sorted files, comm: Selects or 
intro: Introduction to machine 
lorder: Finds ordering 
join: Joins two 
for a common object file 
Modules. 86rel: Intel 8086 
strip: Removes symbols and 
common object file reloc: 
show current layer 
value, floor, ceiling and 
calendar: Invokes a 
remote XENIX system, 
rmail: submit 
uutry: try to contact 
ct: spawn getty to a 
uux: Executes command on 
remote: Executes commands on a 
del.vd: 
file rmb: 
removepkg: 
configuration/ idaddld: add or 
directories specified cleantmp: 
package 
file, rmdel: 
semaphore set or shared/ ipcrm: 
rmdir: 
unlink: 

pathnames, basename: 
rm, rmdir: 
bits, strip: 
device names/ 



received via UUCP 

reconfigures and maintains .... 

record locking on files 

records /command summary . . . 
records fwtmp: fwtmp, wtmpfix: 
records for subsystem events . . . 

recovery service 

red: Invokes a restricted 

reduce: perform audit data .... 

reduction reduce: 

regcmp: Compiles and executes . . 
regcmp: Compiles regular .... 
regenerates groups of programs, 
regex, regcmp: Compiles and . . . 
regexp: Regular expression . . . 

region executable 

region for reading or writing. . . . 
Regular expression compile and 
regular expressions, regex, . . . 

regular expressions 

rejects lines common to two . . . 
related miscellaneous features/ . . 

relation for an object library 

relations 

reloc: relocation information . . . 
Relocatable Format for Object . . 

relocation bits 

relocation information for a ... 
relogin: rename login entry to . . 
remainder functions, /absolute . . 

reminder service 

remote: Executes commands on a . 
remote mail received via UUCP 
remote system with debugging on . 

remote terminal 

remote XENIX 

remote XENIX system 

remove a virtual disk 

remove extra blank lines from a . . 
remove installed package . . . . 

remove line disciplines from kernel 
remove temporary files in . . . . 
removepkg: remove installed . . . 
Removes a delta from an SCCS . . 
Removes a message queue, . . . 

Removes directories 

Removes directory entry 

Removes directory names from . . 
Removes files or directories. . . . 
Removes symbols and relocation 
removing specific hard disk . . . 



rmail(ADM) 

Ipinit(ADM) 

lockf(S) 

acctcms(ADM) 

fwtmp(ADM) 

dlvr_audit(ADM) 

rcstart(M) 

red(Q 

reduce(ADM) 

reduce(ADM) 

regex(S) 

regcmp(CP) 

make(CP) 

regex(S) 

regexp(S) 

execseg(S) 

locking(S) 

regexp(S) 

regex(S) 

regcmp(CP) 

comm(Q 

Intro(HW) 

lorder(CP) 

join(C) 

reloc(F) 

86iel(F) 

strip(CP) 

reloc(F) 

relogin(ADM) 

floor(S) 

calendar(C) 

rcmote(C) 

imail(ADM) 

uutry(ADM) 

ct(C) 

uux(C) 

remote(C) 

del.vd(ADM) 

rmb(M) 

removepkg(ADM) 

idaddld(ADM) 

cleantmp(ADM) 

removepkg(ADM) 

rmdel(CP) 

ipcrm(ADM) 

rmdir(C) 

unlink(S) 

basename(C) 

rm(C) 

strip(CP) 

hdutil(ADM) 
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current layer relogin: rename login entry to show . . . relogin(ADM) 

directory, rename: renames a file or .... rename(DOS) 

rename: renames a file or directory rename(DOS) 

mv: Moves or renames files and directories. . . . mv(C) 

mirrored disk vdutil: repair bad block on a vdutil(ADM) 

fsck: Checks and repairs file systems fsck(ADM) 

uniq: Reports repeated lines in a file uniq(C) 

yes: Prints string repeatedly yes(C) 

Generate an IMAGEN accounting report, imacct: imacct(C) 

fsstat: report file system status fsstat(ADM) 

checkque: MMDF queue status report generator checkque(ADM) 

blocks, df: Report number of free disk .... df(C) 
sa2, sadc - system activity report package sar: sar, sal, . . . sar(ADM) 

activity timex: time a command; report process data and system . . timex(ADM) 

clock: Reports CPU time used clock(S) 

cmchk: Reports hard disk block size. . . . cmchk(C) 

ps: Reports process status ps(Q 

file, uniq: Reports repeated lines in a .... uniq(C) 
pstat: Reports system information. . . . pstat(Q 

inter-process/ ipcs: Reports the status of ipcs(ADM) 

vmstat: Reports virtual memory statistics. . vmstat(C) 
stream, fseek, ftell, rewind: Repositions a file pointer in a ... fseek(S) 
Starts/stops the lineprinter request. Apshut, Ipmove: .... Ipsched(ADM) 

Ip, cancel: Send/cancel requests to lineprinter lp(Q 

terminal jterm: reset layer of windowing .... jterm(C) 

/Awaits and checks access to a resource governed by a/ waitsem(S) 

ev_resume: Restart a suspended queue. . . . ev_resume(S) 

vdutil: restart I/O on a mirrored disk . . vdutil(ADM) 

incremental file/ restore, restor: Invokes restore(ADM) 

incremental filesystem backup restore /AT&T UNIX restore(ADM) 

incremental filesystem backup/ restore: AT&T UNIX restore(ADM) 

Invokes incremental file system/ restore, restor: restore(ADM) 

Invokes incremental file system restorer, /restor: restore(ADM) 

incremental file system restorer. /Invokes XENIX .... xrestore(ADM) 
privs: print and/or restrict privileges temporarily . . privs(C) 

a program promain: restrict the execution domain of . . promain(M) 

programming language rksh: restricted command and ksh(C) 

interpreter), rsh: Invokes a restricted shell (command .... rsh(C) 

red: Invokes a restricted version of. red(C) 

fp_off, Ip_seg: Return offeet and segment fp_seg(DOS) 

ev_getemask: Return the current event mask. . . ev_gtemsk(S) 
ismpx: return windowing terminal state . ismpx(C) 
stat: Data returned by stat system call. . . . stat(F) 

inp: Returns a byte inp(DOS) 

console buffer, ungetch: Returns a character to the .... ungetch(DOS) 
value, abs: Returns an integer absolute . . . abs(S) 

idcheck: returns selected information . . . idcheck(ADM) 
long integer, labs: Returns the absolute value of a . . labs(DOS) 

strlen: Returns the length of a string. . . strlen(DOS) 

currently in the/ ev_count: Returns the number of events . . . ev_count(S) 

value, false: Returns with a nonzero exit . . . false(C) 
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true: 
col: Filters 
in a string, strrev: 
pointer in a/ fseek, fiell, 
creat: Creates a new file or 
programming language 
directories, 
received via UUCP 
from a file 
sees file. 



directories, rm, 
chroot: Changes the 
chroot: Changes 
logarithm, power, square 
supported network, mmdf: 
expression compile and match 
Id fen: common object file access 
/system services, library 
points in a driver object/ 
/a XENlX-style UUCP 
/converts a XENIX-style Micnet 
/hashed database of alias and 
(command interpreter). 

multiuser environment rc2: 
the operating system rcO: 
runacct: 

/pretmp, prdaily, prtacct, 
priority, nice: 
and quits, nohup: 
activity report/ sar: sar, 
report package sar: sar, sal, 
editing activity, 
package sar: sar, sal, sa2, 

purge: the policy file of the 
activity report package sar: 
system activity report package 
space allocation, 
work, uucico: 
and formats input. 

bfs: 

creates bad track/ badtrk: 
help: Asks for help about 
the delta commentary of an 
comb: Combines 
Compares two versions of an 
Makes a delta (change) to an 



Returns with a zero exit value. . . 

reverse linefeeds 

Reverses the order of characters 
rewind: Repositions a file .... 

rewrites an existing one 

rksh: restricted command and . . 
rm, rmdir: Removes files or ... 
rmail: submit remote mail .... 
rmb: remove extra blank lines . . 
rmdel: Removes a delta from an 

rmdir: Deletes a directory 

rmdir: Removes directories. . . . 

rmdir: Removes files or 

root directory 

root directory for command. . . . 
root functions, /exponential, . . . 
routes mail locally and over any 
routines, regexp: Regular .... 

routines 

routines and error numbers. . . . 
routines: finds driver entry .... 

routing file to MMDF/ 

routing file to MMDF/ 

routing information 

rsh: Invokes a restricted shell . . . 
rtc: real time clock interface . . . 
run commands performed for ... 
run commands performed to stop 

run daily accounting 

runacct: run daily accounting . . . 
runacct, shutacct, startups .... 
Runs a command at a different . . 
Runs a command immune to hangups 

sal , sa2, sadc - system 

sa2, sadc - system activity .... 
sact: Prints current SCCS file ... 
sadc - system activity report . . . 
sag: system activity graph .... 
sanitization utility purge(C) . . . 
sar, sal, sa2, sadc - system .... 

sar: sar, sal, sa2, sadc - 

sbrk, brk: Changes data segment 
Scan the spool directory for ... 
scanf, fscanf, sscanf: Converts . . 

Scans big files 

Scans fixed disk for flaws and . . 

SCCS commands 

SCCS delta, ede: Changes .... 

SCCS deltas 

SCCS file, scesdiff. 

SCCS file, delta: 



true(C) 

col(C) 

strrev(DOS) 

fseek(S) 

creat(S) 

ksh(C) 

rm(C) 

rmail(ADM) 

nnb(M) 

rmdel(CP) 

rmdir(DOS) 

rmdir(C) 

rm(C) 

chroot(S) 

chroot(ADM) 

exp(S) 

mmdf(ADM) 

regexp(S) 

ldfcn(F) 

Intro(S) 

routines(ADM) 

uulist(ADM) 

mnlist(ADM) 

dbmbuild(ADM) 

rsh(C) 

rtc(HW) 

rc2(ADM) 

rcfXADM) 

runacct(ADM) 

runacct(ADM) 

acctsh(ADM) 

nice(C) 

nohup(C) 

sar(ADM) 

sar(ADM) 

sact(CP) 

sar(ADM) 

sag(ADM) 

purge(F) 

sar(ADM) 

sar(ADM) 

sbiic(S) 

uucico(C) 

scanf(S) 

bfs(C) 

badtik(ADM) 

help(CP) 

cdc(CP) 

comb(CP) 

sccsdifi(CP) 

delta(CP) 
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Undoes a previous get of an SCCS file, unget: unget(CP) 

prs: Prints an SCCS file prs(CP) 

rmdel: Removes a delta from an SCCS file rmdel(CP) 

sccsfile: Format of an SCCS file sccsfilc(F) 

val: Validates an SCCS file val(CP) 

sact: Prints current SCCS file editing activity sact(CP) 

admin: Creates and administers SCCS files admin(CP) 

of an SCCS file, sccsdiffi Compares two versions . sccsdiff(CP) 

file, sccsfile: Format of an SCCS . . . sccsfile(F) 

system backups schedule: Database for automated . schedule(ADM) 
transport program uusched: the scheduler for the uucp file .... uusched(ADM) 
common object file scnhdr: section header for a ... scnhdr(F) 
screen image file. scr_dump: format of curses . . . scr_dump(F) 

clear: Qears a terminal screen clear(C) 

curses: Performs screen and cursor functions. . , . curses(S) 

setcolor: Set screen color setcolor(C) 

scr_dump: format of curses screen image file scr_dump(F) 

convkey: Configure monitor screen mapping. Anapstr, .... mapkey(M) 

color, monochrome, ega,. screen: tty [01 -«], screen(HW) 

vi, view, vedit: Invokes a screen-oriented display editor. . . vi(C) 

XENIX installation shell script xinstall: xinstall(ADM) 

install: Installation shell script install(M) 

scsinfo: display current SCSI device information .... scsinfo(ADM) 
scsinfo: display current SCSI hard disk information . . . scsinfo(ADM) 

interface, scsi: Small computer systems . . . scsi(HW) 

scsinfo: display current SCSI tape drive information . . . scsinfo(ADM) 

sdb: Invokes symbolic debugger. . sdb(CP) 

dates, sddate: Prints and sets backup . . sddate(C) 

access to a shared data/ sdenter, sdleave: Synchronizes . . sdenter(S) 

sdevice: file format sdevice(F) 

shared data segment, sdget, sdfree: Attaches and detaches a . . sdget(S) 

detaches a shared data segment, sdget, sdfree: Attaches and . . . sdget(S) 

shared data access, sdgetv, sdwaitv: Synchronizes . . sdgetv(S) 

side-by-side, sdiff. Compares files sdififiJC) 

a shared data segment, sdenter, sdleave: Synchronizes access to . sdenter(S) 
data access, sdgetv, sdwaitv: Synchronizes shared . . sdgetv(S) 

bsearch: Performs a binary search bsearch(S) 

Isearch, Ifind: Performs linear search and update Isearch(S) 

hcreate, hdestroy: Manages hash search tables, hsearch, hsearch(S) 

tdelete, twalk: Manages binary search trees, tsearch, tfind, . . . tsearch(S) 

grep, egrep, fgrep: Searches a file for a pattern. . . . grep(C) 

accounting files, acctcom: Searches for and prints process . . acctcom(ADM) 

pattern in a file, awk: Searches for and processes a ... awk(C) 

object file scnhdr: section header for a common . . . scnhdr(F) 

getty initcond: special security actions for init and . . . initcond(ADM) 

description subsystem: security subsystem component . . subsystem (M) 

sed: Invokes the stream editor. . . sed(C) 

unifonnly distributed. srand48, seed48, lcong48: Generates . . . drand48(S) 

access to a shared data segment, /sdleave: Synchronizes . sdenter(S) 

and detaches a shared data segment, /sdfree: Attaches . . . sdget(S) 

brkctl: Allocates data in a far segment bikctl(S) 
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fp_seg: Return offeet and segment. fp_off, fp_seg(DOS) 

shmget: Gets a shared memory segment shmget(S) 

sbrk, brie: Changes data segment space allocation sbrk(S) 

segread: command description. . . segread(DOS) 

multiplexing, select: synchronous I/O select(S) 

greek: select terminal filter greek(C) 

a file, cut: Cuts out selected fields of each line of . . . cut(C) 

idcheck: returns selected information idcheck(ADM) 

binary files, hdr: Displays selected parts of executable . . . hdr(CP) 

to two sorted files, comm: Selects or rejects lines common . . comm(C) 

Creates an instance of a binary semaphore, creatsem: creatsem(S) 

Signals a process waiting on a semaphore, sigsem: sigsem(S) 

opensem: Opens a semaphore opensem(S) 

to a resource governed by a semaphore, /and checks access . . waitsem(S) 

semctl: Controls semaphore operations semctl(S) 

semop: Performs semaphore operations semop(S) 

iperm: Removes a message queue, semaphore set or shared memory. . ipcrm(ADM) 

semget: Gets set of semaphores semget(S) 

files, lockf: Provide semaphores and record locking on . lockf(S) 

operations, semctl: Controls semaphore . . . semctl(S) 

semget: Gets set of semaphores. . semget(S) 
fsphoto: Performs periodic semi-automated system backups . fsphoto(ADM) 
operations, semop: Performs semaphore . . . semop(S) 

hello: Send a message to another user. . . hello(ADM) 

lineprinter. Ip, cancel: Send/cancel requests to lp(C) 

away revtrip: notifies mail sender that recipient is rcvtrip(C) 

group of processes, kill: Sends a signal to a process or a . . kill(S) 

mail, mail: Sends, reads or disposes of .... mail(Q 

/sys_errlist, sys_nerr, ermo: Sends system error messages. . . perror(S) 

mesg: Permits or denies messages sent to a terminal mesg(C) 

file to printer attached to a serial console /Print consoleprint(ADM) 

mscreen: Serial multiscreens utility .... mscreen(M) 

, tty2[A-H]: Interface to serial ports. /, tty2[a-h] serial(HW) 

calendar: Invokes a reminder service calendar(C) 

error/ intro: Introduces system services, library routines and . . . Intro(S) 

disable auditing for the next session chg_audit: enables and . . chg_audit(ADM) 

Map of the ASCII character set. ascii: ascii(M) 

peu: set port configuration pcu(ADM) 

buffering to a stream, setbuf, setvbuf: Assigns setbuf(S) 

real-time (time of day) clock, setclock: Sets the system .... setclock(ADM) 

setcolor: Set screen color setcolor(C) 

setuid, setgid: Sets user and group IDs. . . setuid(S) 

getgrent, getgrgid, getgmam, setgrent, endgrent: Get group/ . . getgrent(S) 

nonlocal “goto”, setjmp, longjmp: Performs a . . . setjmp(S) 

keys, setkey: Assigns the function . . . se^ey(C) 

international environment setlocale: Set or read setlocale(S) 

table, setmnt: Establishes /etc/mnttab . . setmnt(ADM) 
setmode: Sets translation mode. . . setmode(DOS) 
setpgrp: Sets process group ID. . . setpgrp(S) 
getpwent, getpwuid, getpwnam, setpwent, endpwent: Gets/ .... getpwent(S) 
trehan: Translate character sets trchan(M) 
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alarm: Sets a process* alarm clock. . . . alarm(S) 

to one charater. strset: Sets all characters in a string . . . strset(DOS) 
mask, umask: Sets and gets file creation .... umask(S) 

sddate: Prints and sets backup dates sddate(C) 

execution, env: Sets environment for command . . env(C) 

ev_setemask: Sets event mask ev_stemsk(S) 

modification times, utime: Sets file access and utime(S) 

umask: Sets file-creation mode mask. . . umask(Q 

setpgrp: Sets process group ID setpgrp(S) 

tset: Sets terminal modes tset(Q 

speed, and line/ getty: Sets terminal type, modes getty(M) 

base, cmos: Displays and sets the configuration data .... cmos(HW) 

date: Prints and sets the date. date(Q 

a video device, vidi: Sets the font and video mode for . vidi(C) 
stty: Sets the options for a temiinal. . . stty(C) 

of day) clock, setclock: Sets the system real-time (time . . setclock(ADM) 

stime: Sets the time stime(S) 

setmode: Sets translation mode setmode(DOS) 

time, profile: Sets up an environment at login . . profile(M) 

setuid, setgid: Sets user and group IDs setuid(S) 

ulimit: Gets and sets user limits ulimit(S) 

modification dates of files, settime: Changes the access and . settime(ADM) 

"gettydefs: Speed and terminal" 

group IDs. setuid, setgid: Sets user and . . . setuid(S) 

xprsetup: transparent printer setup utility xprsetup(ADM) 

stream, setbuf, setvbuf: Assigns buffering to a . . setbuf(S) 

sfsys: file format sfsys(F) 

(F) sfsys: file format sfsys 

data in a/ sputl, sgetl: Accesses long integer . . . sputl(S) 

inteipreter. sh: Invokes the shell command . . sh(C) 

sdgetv, sdwaitv: Synchronizes shared data access sdgetv(S) 

Synchronizes access to a shared data segment, /sdleave: . . sdenter(S) 

sdfree: Attaches and detaches a shared data segment, sdget, . . . sdget(S) 

message queue, semaphore set or shared memory, ipcrm: Removes a ipcrm(ADM) 
shmctl: Controls shared memory operations. . . . shmcil(S) 

shmop: Performs shared memory operations. . . . shmop(S) 

shmget: Gets a shared memory segment shmget(S) 

sopen: Opens a file for shared reading and writing. . . . sopen(DOS) 

system: Executes a shell command system(S) 

rsh: Invokes a restricted shell (command interpreter). . . . rsh(C) 

sh: Invokes the shell command interpreter sh(C) 

C-like syntax, csh: Invokes a shell command interpreter with . . csh(C) 

shl: Shell layer manager shl(C) 

Change login, group, or dialup shell password, passwd: .... passwd(C) 

/shutacct, startup, tumacct shell procedures for/ acctsh(ADM) 

/shutacct, startup, tumacct - shell procedures for accounting . . acctsh(ADM) 

install: Installation shell script. install(M) 

xinstall: XENIX installation shell script xinstall(ADM) 

shl: Shell layer manager shl(C) 

operations, shmctl: Controls shared memory . shmctl(S) 
segment, shmget: Gets a shared memory . . shmget(S) 
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operations, shmop: Performs shared memory . shmop(S) 

nap: Suspends execution for a short interval nap(S) 

/prdaily, prtacct, runacct, shutacct, startup, tumacct -/ ... acctsh(ADM) 

halts the CPU. shutdn: Flushes block I/O and . . shutdn(S) 

performs power failure shutdown service powerfail(M) 

processing, shutdown: Terminates all .... shutdown(ADM) 
Closes out the file systems and shuts down the system, /reboot: . haltsys(ADM) 

sdifT: Compares files side-by-side sdifB^C) 

what to do upon receipt of a signal, signal: Specifies signal(S) 

Suspends a process until a signal occurs, pause: pause(S) 

upon receipt of a signal, signal: Specifies what to do ... signal(S) 
of processes, kill: Sends a signal to a process or a group . . . kill(S) 

gsignal: Implements software signals, ssignal ssignal(S) 

semaphore, sigsem: Signals a process waiting on a . . sigsem(S) 
waiting on a semaphore, sigsem: Signals a process .... sigsem(S) 
atan2: Performs trigonometric/ sin, cos, tan, asin, acos, atan, . . . trig(S) 

sulogin: access single-user mode sulogin(ADM) 

hyperbolic functions, sinh, cosh, tanh: Performs .... sinh(S) 

cmchk: Reports hard disk block size cmchk(C) 

chsize: Changes the size of a file chsize(S) 

size: Prints the size of an object file size(CP) 

j win: print size of layer jwin(C) 

object file, size: Prints the size of an .... size(CP) 
interval, sleep: Suspends execution for an . sleep(C) 

interval, sleep: Suspends execution for an . sleep(S) 

current/ ttyslot: Finds the slot in the utmp file of the .... ttyslot(S) 

checker smmek: trusted computing base , tcbck(ADM) 

spline: Interpolates smooth curve spline(CP) 

swconfig: produces a list of the software modifications to the/ . . swconfig(C) 

ssignal, gsignal: Implements software signals ssignal(S) 

reading and writing, sopen: Opens a file for shared . . sopen(DOS) 

qsort: Performs a quicker sort qsort(S) 

sort: Sorts and merges files. . . . sort(C) 

or rejects lines common to two sorted files, comm: Selects . . . comm(C) 

tsort: Sorts a file topologically tsort(CP) 

sort: Sorts and merges files sort(C) 

an error message file from C source, mkstr: Creates mkstr(CP) 

idspace: investigates free space idspace(ADM) 

sbrk, brk: Changes data segment space allocation sbrk(S) 

ct: spawn getty to a remote terminal . ct(C) 

process, spawn!, spawnvp: Creates a new . spawn(DOS) 

spawnl, spawnvp: Creates a new process. . spawn(DOS) 

movedata: Copies bytes from a specific address movedata(DOS) 

sysi86: machine specific functions sysi86(S) 

fspec: format specification in text files .... fspec(F) 

idmkinit: read files containing specifications idmkinit(ADM) 

temporary files in directories specified cleantmp: remove . . . cleantmp(ADM) 

purge: overwrites specified files purge(C) 

/the list of vectors currently specified in the s d e v i c e/ . vectorsinuse(ADM) 

Anajor device numbers currently specified in the mdevice file . . . majorsinuse(ADM) 

cron: Executes commands at specified times cron(C) 
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receipt of a signal, signal: Specifies what to do upon * . . . signal(S) 

/Sets terminal type, modes, speed, and line discipline getty(M) 

/set terminal type, modes, speed, and line discipline .... uugetty(ADM) 
by getty. "gettydefs:" Speed and terminal settings used . gettydefs(F) 
hashcheck: Finds spelling/ spell, hashmake, spellin, .... spell(C) 
spelling/ spell, hashmake, spellin, hashcheck; Finds .... spell(C) 
spellin, hashcheck: Finds spelling errors, /hashmake, . . . spell(C) 

curve, spline: Interpolates smooth . . . spline(CP) 

pieces, split: Splits a file into split(C) 

split: Splits a file into pieces split(C) 

context, csplit: Splits files according to csplit(C) 

into a/ frexp, Idexp, modf: Splits floating-point number . . . frexp(S) 

uuclean: uucp spool directory clean-up uuclean(ADM) 

uucico: Scan the spool directory for work: uucico(C) 

Configures the lineprinter spooling system. Ipadmin: .... Ipadmin(ADM) 

printf, fprintf, sprintf: Formats output printf(S) 

integer data in a/ sputl, sgetl: Accesses long .... sputl(S) 

exponentiaiy exp, log, pow, sqrt, loglO: Performs exp(S) 

exponential, logarithm, power, square root functions. /Performs . exp(S) 
number, rand, srand: Generates a random .... rand(S) 

Generates unifonnly/ srand48, seed48, lcong48: .... drand48(S) 

input, scanf, fscanf, sscanf: Converts and formats . . . scanf(S) 

software signals, ssignal, gsignal: Implements . . . ssignal(S) 

output, stdio: Performs standard buffered input and . . . stdio(S) 

Converts Rational FORTRAN into standard FORTRAN, ratfor: . . . ratfor(CP) 

gets: Gets a string from the standard input gets(CP) 

communication package, ftok: Standard interprocess stdipc(S) 

pr: Prints files on the standard output pr(C) 

Ipsched, Ipshut, Ipmove: Starts/stops the lineprinter/ .... Ipsched(ADM) 

/prtacct, runacct, shutacct, startup, tumacct - shell/ acctsh(ADM) 

system call, stat: Data returned by stat .... stat(F) 

stat, fstat: Gets file status stat(S) 

stat: Data returned by stat system call stat(F) 

information, statfs: get file system statfs(S) 

ustat: Gets file system statistics ustat(S) 

xts: extract and print xt driver statistics xts(ADM) 

virtual memory statistics, vmstat: Reports .... vmstat(C) 
fileno: Determines stream status, ferror, feof, clearerr, . . . ferror(S) 

fsstat: report file system status fsstat(ADM) 

ps: Reports process status ps(C) 

stat, fstat: Gets file status stat(S) 

Ipstat: prints lineprinter status information Ipstat(C) 

uustat: UUCP status inquiry and job control. . . uustat(C) 

communication/ ipcs: Reports the status of inter-process ipcs(ADM) 

checkque: MMDF queue status report generator checkque(ADM) 

buffered input and output, stdio: Performs standard stdio(S) 

stime: Sets the time stime(S) 

Waits for a child process to stop or terminate, wait: wait(S) 

rcO: run commands performed to stop the operating system .... rcO(ADM) 

compress: Compress data for storage compress(C) 

nextkey:/ dbminit, fetch, store, delete, firstkey, dbm(S) 
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uncompress: Uncompress a stored file compress(C) 

zcat: Display a stored file compress(C) 

queue: MMDF queue files for storing mail in transit queue(ADM) 

trace messages strace: Prints STREAMS strace(ADM) 

logger cleanup program strclean: STREAMS error .... strclean(ADM) 

operations, strdup: Perfomis string string(S) 

Gets a character from a stream, fgetc, fgetchar: fgetc(DOS) 

Gets character or word from a stream, /getchar, fgetc, getw: . . getc(S) 

Prints the first few lines of a stream, head: head(C) 

Pushes character back into input stream, ungetc: ungetc(S) 

Puts a character or word on a stream, ^utchar, ^utc, putw: . . putc(S) 

Repositions a file pointer in a stream, fseek, ftell, rewind: . . . fseek(S) 

fllush: Closes or flushes a stream, fclose, fclose(S) 

fgets: Gets a string from a stream, gets, gets(S) 

fopen, freopen, fdopen: Opens a stream fopen(S) 

fputchar: Write a character to a stream, fputc, fputc(DOS) 

puts, fputs: Puts a string on a stream puts(S) 

setvbuf: Assigns buffering to a stream, setbuf, setbuf(S) 

Invokes the stream editor, sed: sed(C) 

clearerr, fileno: Determines stream status, ferror, feof, .... ferror(S) 

fclose, fcloseall: Closes streams fclose(DOS) 

cleanup program strclean: STREAMS error logger strclean(ADM) 

daemon strerr: STREAMS error logger strerr(ADM) 

strace: Prints STREAMS trace messages .... strace(ADM) 
for networking/ strmtune: STREAMS configuration interface . strmtune(ADM) 
strmcfg: STREAMS configuration utility . . strmcfg(ADM) 
strmcfg: STREAMS parameter calculated . strmcfg(ADM) 

logger daemon strerr: STREAMS error strerr(ADM) 

string strftime: format date/time .... strftime(S) 

cgets: Gets a string cgets(DOS) 

strftime: format date/time string strftime(S) 

strlen: Returns the length of a string strlen(DOS) 

the order of characters in a string, strrev: Reverses strrev(DOS) 

files gps: graphical primitive string, format of graphical .... gps(F) 

gets, fgets: Gets a string from a stream gets(S) 

getclk: gets string from real-time clock .... getclk(M) 
gets: Gets a string from the standard input. . . gets(CP) 

puts, ^uts: Puts a string on a stream puts(S) 

strdup: Performs string operations string(S) 

yes: Prints string repeatedly yes(C) 

strtod, atof: Converts a string to a double-precision/ . . . strtod(S) 

strtol, atol, atoi: Converts string to integer strtol(S) 

strset: Sets all characters in a string to one charater strset(DOS) 

cputs:Putsa string to the console cputs(DOS) 

strings in an object file, strings: Finds the printable .... strings(CP) 

xstr: Extracts strings from C programs. .... xstr(CP) 

strings: Finds the printable strings in an object file strings(CP) 

relocation bits, strip: Removes symbols and . . . strip(CP) 

add.vd: add a striped (virtual) disk add.vd(ADM) 

del.vd: delete a striped (virtual) disk del.vd(ADM) 

vdinfo: display striped (virtual) disk information . vdinfo(ADM) 
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string, strlen: Returns the length of a . . strlen(DOS) 
characters to lowercase, strlwr: Converts uppercase .... strlwr(DOS) 
characters in a string, strrev: Reverses the order of ... strrev(DOS) 
string to one charater. strset: Sets all characters in a ... strset(DOS) 
to a double-precision number, strtod, atof: Converts a string . . . strtod(S) 
string to integer, strtol, atol, atoi: Converts .... strtol(S) 

mount: Mounts a file structure mount(ADM) 

umount: Dismounts a file structure umount(ADM) 

characters to uppercase, strupr: Converts lowercase .... strupr(DOS) 
tenninal. stty: Sets the options for a .... stty(C) 

stune: file format stune(F) 

(F) stune: file format stune 

or another user, su: Makes the user a super-user . . su(Q 

submit: MMDF mail enqueuer . . submit(ADM) 
UUCP rmail: submit remote mml received via . miail(ADM) 
/checks for mail which has been submitted but not delivered . . . checkmail(C) 

interface for authorization subsystem /administrator .... authtsh(ADM) 
command interface for audit subsystem activationy auditcmd: . auditcmd(ADM) 

files generated by the audit subsystem and /audit collection . auditd(ADM) 
subsystem: security subsystem component description . subsystem(M) 
produce audit records for subsystem events dlvr_audit: . . dlvr_audit(ADM) 

audit: audit subsystem interface device . . . audit(ADM) 

component description subsystem: security subsystem . . subsystem(M) 
sulogin: access single-user mode . sulogin(ADM) 
counts blocks in a file, sum: Calculates checksum and . . sum(Q 

du: Summarizes disk usage du(C) 

ownership, quot: Summarizes file system quot(Q 

accounting/ acctcms: command summary from per-process .... acctcms(ADM) 

sync: Updates the super-block. sync(ADM) 

sync: Updates the super-block sync(S) 

su: Makes the user a super-user or another user su(Q 

keyboard mode or test keyboard support kbmode: Set kbmode(ADM) 

routes mail locally and over any supported network, mmdf: . . . mmdf(ADM) 

terminals: List of supported terminals terminals(M) 

ev_resume: Restart a suspended queue ev_resume(S) 

signal occurs, pause: Suspends a process until a . . . . pause(S) 

ev_suspend: Suspends an event queue ev_susp(S) 

interval, nap: Suspends execution for a short . . nap(S) 

interval, sleep: Suspends execution for an .... sleep(C) 

interval, sleep: Suspends execution for an .... sleep(S) 

swab: Swaps bytes swab(S) 

swap: swap administrative interface . . swap(ADM) 

swapadd: Adds swap area swapadd(S) 

interface swap: swap administrative .... swap(ADM> 
swapadd: Adds swap area .... swapadd(S) 

swab: Swaps bytes swab(S) 

fdswap: Swaps default boot floppy drive. . fdswap(ADM) 
software modifications to the/ swconfig: produces a list of the . . swconfig(C) 
sxt: Pseudo-device driver. .... sxt(M) 

syms: common object file symbol table format syms(F) 

unistd: file header for symbolic constants unistd(F) 
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sdb: Invokes symbolic debugger sdb(CP) 

strip: Removes symbols and relocation bits. . . . strip(CP) 

table format syms: common object file symbol . syms(F) 

sync: Updates the super-block. . . sync(ADM) 

sync: Updates the super-block. . . sync(S) 

data segment, sdenter, sdleave: Synchronizes access to a shared . sdenter(S) 

sdgetv, sdwaitv: Synchronizes shared data access. . sdgetv(S) 

select: synchronous I/O multiplexing. . . select(S) 

Checks C language usage and syntax, lint: lint(CP) 

command interpreter with C-like syntax, esh: Invokes a shell . . . csh(C) 

administration utility, sysadmsh: Menu driven system . . sysadmsh(ADM) 

parameters sysdef: output values of tunable . . sysdef(ADM) 

Sends system error/ perror, sys_errlist, sys_nerr, ermo: . . . perror(S) 

sysfiles: Format of UUCP Sysfiles file sysfiles(F) 

Sys files file, sysfiles: Format of UUCP .... sysfiles(F) 

functions. sysi86: machine specific .... sysi86(S) 

error/ perror, sys_errlist, sys_nerr, ermo: Sends system . . perror(S) 

Automatically boots the system, autoboot: autoboot(ADM) 

Gets name of current XENIX system, uname: uname(S) 

commands on a remote XENIX system, remote: Executes .... remote(C) 

config: Configures a XENIX system config(ADM) 

cu: Calls another XENIX system cu(C) 

file systems and shuts down the system, /reboot: Closes out the . . haltsys(ADM) 

mkfs: Constructs a file system mkfs(ADM) 

mount: Mounts a file system mount(S) 

the lineprinter spooling system. Ipadmin: Configures . . . Ipadmin(ADM) 

the name of the current XENIX system, uname: Prints uname(C) 

umount: Unmounts a file system umount(S) 

who: Lists who is on the system who(C) 

sar: sar, sal, sa2, sadc system activity report/ sar(ADM) 

uconfig: system hardware changing . . . uconfig(ADM) 

uconfig: changing system hardware uconfig(ADM) 

procedures bre: bre, bcheckrc system initialization brc(ADM) 

information file cardjnfo: system tty controller card .... card_info 
map file xprtab: system tty transparent printer . . . xprtab(F) 

identification file, systemid: The Micnet system . . . systemid(F) 

- mount, unmount multiple file systems /mountall, umountall . . mountall(ADM) 

fsck: Checks and repairs file systems fsck(ADM) 

labelit: provide labels for file systems labelit(ADM) 

rep: Copies files across XENIX systems rcp(C) 

/reboot: Closes out the file systems and shuts down the/ . . . h^tsys(ADM) 

systems: Format of UUCP Systems file systems(F) 

file, systems: Format of UUCP Systems systems(F) 

scsi: Small computer systems interface scsi(HW) 

checklist: List of file systems processed hy fsck checklist(F) 

device, systty: System maintenance . . . systty(M) 

Format of mounted file system table, mnttab: mnttab(F) 

chrtbl: create a ctype locale table chrtbl(M) 

create a collation locale table coltbl: coltbl(M) 

curtbl: create a currency locale table curtbl(M) 

for flaws and creates bad track table, badtrk: Scans fixed disk . . badtrk(ADM) 
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numtbl: Create a numeric locale table numtbl(M) 

setmnt: Establishes /etc/mnttab table setmnt(ADM) 

syms: common object file symbol table format syms(F) 

NIC database into channel/domain tables nictable: process nictable(ADM) 

hdestroy: Manages hash search tables, hsearch, hcreate hsearch(S) 

tables: MMDF Name Tables tables(F) 

term: Terminal driving tables for nrofif. term(F) 

tables: MMDF Name Tables . . . tables(F) 

tabs: set tabs on a terminal tabs(C) 

tabs: set tabs on a terminal .... tabs(C) 

ctags: Creates a tags file ctags(CP) 

a file, tail: Delivers the last part of ... tail(C) 

Performs/ sin, cos, tan, asin, acos, atan, atan2: .... trig(S) 
functions, sinh, cosh, tanh: Performs hyperbolic .... sinh(S) 

Otar: original tape archive command otar(C) 

tape device tapecntl: AT&T tape control for Q1C-24/QIC-02 . . tapecntl(C) 
tape control for QIC-24/QIC-02 tape device tapecntl: AT&T . . . tapecntl(C) 

scsinfo: display current SCSI tape drive information scsinfo(ADM) 

backup: Incremental dump tape forniat backup(F) 

program, tape: Magnetic tape maintenance . tape(C) 
tape: Magnetic tape maintenance program. . . . tape(C) 

tapedump: Dumps magnetic tape to output file tapedump(C) 

QIC-24/QIC-02 tape device tapecntl: AT&T tape control for . . tapecntl(C) 
output file, tapedump: Dumps magnetic tape to tapedump(C) 

tar: archive format tar(F) 

tar: Archives files tar(C) 

search trees, tsearch, tfind, tdelete, twalk: Manages binary . . tsearch(S) 

tee: Creates a tee in a pipe. . . . tee(C) 

tee: Creates a tee in a pipe tee(C) 

4014: paginator for the TEKTRONIX 4014 terminal . . . 4014(C) 

last logins of users and teletypes last: Indicate last(C) 

temporary file, tmpnam, tempnam: Creates a name for a . . tmpnam(S) 

print and/or restrict privileges temporarily privs: privs(C) 

tempnam: Creates a name fora temporary file, tmpnam, .... tmpnam (S) 

tmpfile: Creates a temporary file tmpfile(S) 

specified cleantmp: remove temporary files in directories . . . cleantmp(ADM) 

for nrofif. term: Terminal driving tables . . . term(F) 

'’terminfo/" captoinfo: convert a termcap description into a .... captoinfo(ADM) 
database, termcap: Terminal capability . . . termcap(M) 

Generates a filename for a termini, ctermid: ctermid(S) 

a printer attached to the user’s terminal Iprint: Print to Iprint(C) 

ct: spawn getty to a remote terminal ct(C) 

for the 5620 DMD terminal /object downloader . . . wtinit(ADM) 

host control of windowing terminal jagent: jagent(M) 

isatty: Finds the name of a terminal, ttyname, ttyname(S) 

j term: reset layer of windowing terminal jterm(C) 

lock: Locks a user’s terminal lock(C) 

of the DASI 450 terminal /special functions . . . 450(C) 

or denies messages sent to a terminal, mesg: Permits mesg(C) 

paginator for the TEKTRONIX 4014 terminal 4014: 4014(C) 

stty: Sets the options for a terminal. stty(C) 



1-66 




Permuted Index 



tabs: set tabs on a terminal tabs(C) 

terminal: Login terminal terminal(HW) 

termcap: Terminal capability data base. . . termcap(M) 

"terminfo:" terminal capability data base. . . . terminfo(M) 

"terminfo:" terminal description database. . . terminfo(S) 

nroff. term: Tbrminal driving tables for ... . term(F) 

greek: select terminal filter gneek(C) 

tgetstr, tgoto, tputs: Performs terminal functions. Agetflag, . . . termcap(S) 

termio: General terminal interface termio(M) 

termios: POSIX general terminal interface termios(M) 

tty: Special terminal interface tty(M) 

dial: Establishes an out-going terminal line connection dial(S) 

terminal: Login terminal terminal(HW) 

tset: Sets terminal modes tset(Q 

clear: Clears a terminal screen clear(C) 

"gettydefs: Speed and" .... terminal settings used by getty. 

ismpx: return windowing terminal state ismpx(C) 

line discipline uugetty: set terminal type, modes, speed, and . uugetty(ADM) 

line discipline, getty: Sets terminal type, modes, speed, and . getty(M) 

used between host and windowing terminal under layers: protocol . . layers(M) 

functions of Hewlett-Packard terminals hp: handle special . . . hp(C) 

layer multiplexer for windowing terminals layers: layers(C) 

of DASI 300 and 300s terminals /special fimctions . . . 300(Q 

terminals: List of supported terminals terminals(M) 

tty driver for AT&T windowing terminals xt: multiplexed .... xt(HW) 

enable: T\ims on terminals and line printers enable(C) 

disable: TUms off terminals and printers. ..... disable(C) 

inittab: Alternative login terminals file inittab(F) 

terminals, terminals: List of supported . . . terminals(M) 

tty: Gets the terminal’s name tty(C) 

for a child process to stop or terminate, wait: Waits wait(S) 

exit, _exit: Terminates a process exit(S) 

kill: Terminates a process kill(C) 

shutdown: Terminates all processing shutdown(ADM) 

exit: Terminates the calling process. . . exit(DOS) 

for audit subsystem activation, termination, /command interface . auditcmd(ADM) 

tic: "Terminfo compiler." 

tput: Queries the "terminfo database." 

a tcrmcap description into a "terminfo description" /convert 

infoemp: compare or print out "terminfo descriptions" 

"terminfo: Format of compiled" 

"terminfo file." "terminfo: Format 

database, "terminfo: terminal capability" 

database, "terminfo: terminal description" 

interface, termio: General terminal .... termio(M) 
interface, termios: POSIX general terminal . termios(M) 

kbmode: Set keyboard mode or test keyboard support kbmode(ADM) 

test: Tests conditions test(C) 

test: Tests conditions test(Q 

ed: Invokes the text editor ed(C) 

ex: Invokes a text editor ex(C) 
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casual users) edit: text editor (variant of ex for . . . edit(C) 

newform: Changes the format of a text file newform(C) 

diff. Compares two text files. difiR^C) 

fspec: format specification in text files fspec(F) 

imprint: Prints text files on an IMAGEN printer. . imprint(C) 

plock: Lock process, text, or data in memory plock(S) 

binary search trees, tsearch, tfind, tdelete, twalk: Manages . . tsearch(S) 

tgetstr, tgoto, tputs: Performs/ tgetent, tgetnum, tgetflag, .... termcap(S) 
Performs/ tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs: . . . teimcap(S) 

tgoto, tputs: Performs/ tgetent, tgetnum, tgetflag, tgetstr, .... termcap(S) 
tgetent, tgetnum, tgetflag, tgetstr, tgoto, tputs: Performs/ . . termcap(S) 
/tgetnum, tgetflag, tgetstr, tgoto, tputs: Performs terminal/ . . termcap(S) 

tic: Terminfo compiler tic(C) 

Executes commands at a later time, at, batch: at(C) 

Sets up an environment at login time, profile: profile(M) 

stime: Sets the time stime(S) 

time, ftime: Gets time and date. . . time(S) 

Sets the system real-time (time of day) clock, setclock: . . setclock(ADM) 

clock: The system real-time (time of day) clock. clock(F) 

Executes commands at specified times, cron: cron(C) 

Gets process and child process times, times: times(S) 

file access and modification times, utime: Sets utime(S) 

process data and system/ timex: time a command; report . . timex(ADM) 
time zone timezone: set default system . . . timezone(F) 

file, tmpfile: Creates a temporary . . . tmpfile(S) 

for a temporary file, tmpnam, tempnam: Creates a name tmpnam(S) 
/isascii, tolower, toupper, toascii: Classifies or converts/ . . ctype(S) 

conv, toupper, tolower, toascii: Translates characters. . . conv(S) 

characters, conv, toupper, tolower, toascii: Translates .... conv(S) 
/isgraph, iscntrl, isascii, tolower, touR)er, toascii:/ .... ctype(S) 
topology files, top, top.next: The Micnet .... top(F) 
files, top, top.next: The Micnet topology . . top(F) 

tsort: Sorts a file topologically tsort(CP) 

top, top.next: The Micnet topology files top(F) 

acctmerg: merge or add total accounting files acctmerg(ADM) 

modification times of a file, touch: Updates access and .... touch(C) 

/iscntrl, isascii, tolower, toupper, toascii: Classifies or/ . . ctype(S) 
Translates characters, conv, toupper, tolower, toascii: .... conv(S) 

tplot: graphics filters tplot(ADM) 

database, tput: Queries the terminfo .... tput(C) 

/tgetflag, tgetstr, tgoto, tputs: Performs terminal/ .... termcap(S) 

tr: Translates characters tr(C) 

strace: Prints STREAMS trace messages strace(ADM) 

and print xt driver packet traces xtt: extract xtt(ADM) 

ptrace: Traces a process ptrace(S) 

disk for flaws and creates bad track table. /Scans fixed .... badtik:(ADM) 

queue files for storing mail in transit queue: MMDF queue(ADM) 

trchan: Translate character sets trchan(M) 

one format to another translate: Translates files from . . translate(C) 

conv, toupper, tolower, toascii: Translates characters conv(S) 

tr: TYanslates characters tr(C) 
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to another translate: Translates files from one format . . translate(C) 

setmode: Sets translation mode setmode(DOS) 

decode a binary file for transmission via mail uudecode: . uuencode(C) 

encode a binary file for transmission via mail uuencode: . uuencode(C) 

xprsetup: transparent printer setup utility . . xprsetup(ADM) 

file xprtab: system tty transparent printer map xprtab(F) 

line command xpreat: transparent printer over modem . xprcat(C) 

the scheduler for the uucp file transport program uusched: . . . uusched(ADM) 

trehan: Translate character sets . . trchan(M) 

ftw: Walks a file tree ftw(S) 

twalk: Manages binary search trees, tsearch, tfind, tdelete, . . . tsearch(S) 

acos, atan, atan2: Performs trigonometric functions, /asin, . . trig(S) 

tebek: trusted computing base checker . tcbck(ADM) 

i386 - get processor type truth value machid: machid, . . . machid(C) 

with debugging on uutry: try to contact remote system . . . uutry(ADM) 

Manages binary search trees, tsearch, tfind, tdelete, twalk: . . . tsearch(S) 

tset: Sets terminal modes tset(C) 

topologically, tsort: Sorts a file tsort(CP) 

information file cardjnfo: system tty controller card card_info 

mapehan: Configure tty device mapping mapchan(M) 

mapehan: Format of tty device mapping files mapchan(F) 

terminals xt: multiplexed tty driver for AT&T windowing . . xt(HW) 

tty: Gets the terminal’s name. . . tty(C) 

tty: Special terminal interface. . . tty(M) 

file xprtab: system tty transparent printer map . . . xprtab(F) 

monochrome, ega,. screen: tty [01 -n], color, screen(HW) 

tty2[a-h] , tty2[A-H].7 ttyl[a-h] , ttyl[A-H] serial(HW) 

tty2[A-H]: Interface/ tty l[a-h] ttyl[A-H] , tty2[a-h] serial(HW) 

tty2[A-H]:/ ttyl[a-h] , ttyl[A-H] , tty2[a-h] serial(HW) 

Interface/ tty l[a-h] , tty 1[A-H] tty2[a-h] , tty2[A-H]: serial(HW) 

to/ ttyl[a-h] ,ttyl[A-H] , tty2[a-h] , tty 2 [A-H]: Interface . . serial(HW) 

/, tty 1 [A-H] , tty2[a-h] , tty2[A-H]: Interface to serial/ . . serial(HW) 

ports. /, tty 1[ A-H] ,tty2[a-h] tty2[A-H]: Interface to serial . . . serial(HW) 

of a terminal, ttyname, isatty : Finds the name . . ttyname(S) 

utmp file of the current user, ttyslot: Finds the slot in the . . . ttyslot(S) 

attempts to set value of a tunable parameter idtune: .... idtune(ADM) 

sysdef: output values of tunable parameters sysdef(ADM) 

system/ /adjusts tunable parameters to match . . . idmemtune(ADM) 

when adding more memory tunable paramters to be adjusted . memtune(F) 
/runacct, shutacct, startup, tumacct - shell procedures for/ . . acctsh(ADM) 

printers, disable: Turns off terminals and disable(C) 

aceton: T\ims on accounting accton(ADM) 

printers, enable: Turns on terminals and line . . . enable(C) 

trees, tsearch, tfind, tdelete, twalk: Manages binary search . . tsearch(S) 

dtype: Determines disk type. dtype(C) 

file: Determines file type file(C) 

getty: Sets terminal type, modes, speed, and line/ . . . getty(M) 

uugetty: set terminal type, modes, speed, and line/ . . . uugetty(ADM) 

machid, i386 - get processor type truth value machid: .... machid(C) 

types: Primitive system data types. types(F) 

types, types: Primitive system data . . . types(F) 
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variable. TZ: Time zone environment . . . tz(M) 

/localtime, gmtime, asctime, tzset: Converts date and time to/ . ctime(S) 

uadmin: administrative control . . uadmin(ADM) 
uadmin: administrative control. . . uadmin(S) 

limits, ulimit: Gets and sets user .... ulimit(S) 
characters, ultoa: Converts numbers to ... ultoa(DOS) 
creation mask, umask: Sets and gets file .... umask(S) 
mask, umask: Sets file-creation mode . . umask(C) 
structure, umount: Dismounts a file .... umount(ADM) 
umount: Unmounts a file system. . umount(S) 
multiple/ mountall: mountall, umountall - mount, unmount . . . mountall(ADM) 

XENIX system, uname: Gets name of current . . . uname(S) 

current XENIX system, uname: Prints the name of the . . uname(C) 

uncompress: Uncompress a stored file compress(C) 

file, uncompress: Uncompress a stored . compress(C) 
file, unget: Undoes a previous get of an SCCS unget(CP) 
an SCCS file, unget: Undoes a previous get of . . unget(CP) 

into input stream, ungetc: Pushes character back . . ungetc(S) 

the console buffer, ungetch: Returns a character to . . ungetch(DOS) 

seed48, lcong48: Generates uniformly distributed. srand48, . . drand48(S) 

configuration/ upsconfig: uninterruptible power supply . . . upsconfig(ADM) 

a file, uniq: Reports repeated lines in . . uniq(C) 

hostid: print unique hardware ID hostid(ADM) 

mktemp: Makes a unique filename mktemp(S) 

constants unistd: file header for symbolic . . unistd(F) 

units: Converts units units(C) 

units: Converts units units(C) 

backup: performs UNIX backup functions backup(ADM) 

for boards uconfig: UNIX configuration manager . . . uconfig(ADM) 

volcopy: make literal copy of UNIX file system volcopy(ADM) 

optimal access time dcopy: copy UNIX filesystems for dcopy(ADM) 

filesystem backup/ restore: AT&T UNIX incremental restore(ADM) 

link_unix: builds a new UNIX system kernel link_unix(ADM) 

4)rfdc, prfsnap, prfpr - UNIX system profiler profiler(ADM) 

^rfstat, prfdc, prfsnap, prfpr UNIX system profiler profiler(ADM) 

fs: file system - format of UNIX system volume fs(F) 

link: link, unlink: link and unlink files and directories .... link(ADM) 
and directories link: link, unlink: link and unlink files . . . link(ADM) 

unlink: Removes directory entry. . unlink(S) 

reading or/ locking: Locks or unlocks a file region for locking(S) 

/mountall, umountall - mount, unmount multiple file systems . . mountall(ADM) 

umount: Unmounts a file system umount(S) 

files, pack, peat, unpack: Compresses and expands . pack(C) 

Performs linear search and update. Isearch, Ifind: Isearch(S) 

idinstall: add, delete, update, or get device driver/ . . . idinstall(ADM) 

times of a file, touch: Updates access and modification . touch(C) 

of programs, make: Maintains, urates, and regenerates groups . make(CP) 

sync: Updates the super-block sync(ADM) 

sync: Updates the super-block sync(S) 

Converts lowercase characters to uppercase, strupr: strupr(DOS) 

lowercase, strlwr: Converts uppercase characters to strlwr(DOS) 
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utility upsconfig: UPS shutdown configuration . . . upsconfig(ADM) 

about system activity, uptime: Displays information . . . uptime(C) 

du: Summarizes disk usage du(C) 

lint: Checks C language usage and syntax lint(CP) 

clock: Reports CPU time used clock(S) 

keystrokes usemouse: Maps mouse input to . usemouse(C) 

Gets the login name of the user, cuserid: cuserid(S) 

hello: Send a message to another user. hello(ADM) 

in the utmp file of the current user, ttyslot: Finds the slot . . . ttyslot(S) 

logname: Finds login name of user logname(S) 

the user a super-user or another user, su: Makes su(C) 

write: Writes to another user. write(C) 

user, su: Makes the user a super-user or another . . . su(C) 

password/ addxusers: add new user accounts given a XENIX-style addxusers(ADM) 

setuid, setgid: Sets user and group IDs setuid(S) 

id: Prints user and group IDs and names. . . id(C) 

names id: print user and group IDs and id(ADM) 

"crontab:" user crontab file crontab(C) 

/getgid, getegid: Gets real user, effective user, real/ getuid(S) 

environ: The user environment environ(M) 

generate disk accounting data by user ID diskusg: diskusg(ADM) 

getpw: Gets password for a given user ID getpw(S) 

newgrp: Logs user into a new group newgrp(C) 

ulimit: Gets and sets user limits ulimit(S) 

file maildelivery: user mail delivery specification . maildelivery(F) 
group/ /Gets real user, effective user, real group, and effective . . getuid(S) 

editor (variant of ex for casual users) edit: text edit(C) 

finger: Finds information about users finger(C) 

idleout: Logs out idle users idleout(ADM) 

wall: Writes to all users wall(ADM) 

last: Indicate last logins of users and teletypes last(Q 

lock: Locks a user’s terminal lock(C) 

to a printer attached to the user’s terminal Iprint: Print . . . Iprint(C) 

statistics, ustat: Gets file system ustat(S) 

Menu driven audit administration utility auditsh: auditsh(ADM) 

at and cron administration utility atcronsh: Menu driven . . atcronsh(ADM) 

driven backup administration utility backupsh: Menu backupsh(ADM) 

driven system administration utility, sysadmsh: Menu .... sysadmsh(ADM) 
Ip print service administration utility Ipsh: Menu driven .... Ipsh(ADM) 

mscreen: Serial multiscreens utility mscreen(M) 

STREAMS configuration utility for networking products . . strmcfg(ADM) 
policy file of the sanitization utility purge(C) purge: the .... purge(F) 
modification times, utime: Sets file access and .... utime(S) 

utmp, wtmp: Formats of utmp and wtmp entries utmp(F) 

endutent, utmpname: Accesses utmp file entry getut(S) 

ttyslot: Finds the slot in the utmp file of the current user. . . . ttyslot(S) 

wtmp entries, utmp, wtmp: Formats of utmp and . utmp(F) 
entry, endutent, utmpname: Accesses utmp file . . getut(S) 

uuchat: dials a modem dial(ADM) 

directories and permissions/ uucheck: check the uucp .... uucheck(ADM) 

for work, uucico: Scan the spool directory . uucico(C) 
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clean-up 

submit remote mail received via 
Administers 
devices: Format of 
file, dialcodes: Format of 
dialers: Format of 
file uucheck: check the 
uusched: the scheduler for the 
maxuuscheds: 
maxuuxqts: 
uusub: Monitor 
permissions: Format of 
poll: Format of 
uulist: converts a XENIX-style 
uuclean: 
control, uustat: 
sysfiles: Format of 
systems: Format of 
for transmission via mail 
for transmission via mail 
modes, speed, and line/ 
files. 

UUCP routing file to/ 
file copy, uuto, 
maxuuscheds: UUCP 
UUCP file transport program 
job control. 

XENlX-to-XENIX file copy, 
system with debugging on 
XENIX, 
maxuuxqts: UUCP 

val: 

assert: Helps verify 
Returns with a nonzero exit 
abs: Returns an integer absolute 
i386 - get processor type truth 
true: Returns with a zero exit 
ceil, finod: Performs absolute 
getenv: Gets 
labs: Returns the absolute 
idtune: attempts to set 
putenv: Changes or adds 
values: machine-dependent 

sysdef: output 
/Prints formatted output of a 

vdutil: 

TZ: Time zone environment 



uuclean: uucp spool directory . . 

UUCP rmail: 

UUCP control files, uninstall: . . 

UUCP devices file 

UUCP dial-code abbreviations . . 

UUCP Dialers file 

UUCP directories and permissions 
UUCP file transport program . . . 

UUCP uusched limit file 

UUCP uuxqt limit file 

UUCP netwoik 

UUCP Permissions file 

UUCP Poll file 

UUCP routing file to/ 

UUCP spool directory clean-up . . 
UUCP status inquiry and job . . . 

UUCP Sysfiles file 

UUCP Systems file 

uudecode: decode a binary file . . 
uuencode: encode a binary file . . 
uugetty: set terminal type, .... 
uninstall: Administers UUCP control 
uulist: converts a XENIX-style . . 
uupick: Public XENIX-to-XENIX . 

uuschedXmii^t . . 

uusched: the scheduler for the . . 
uustat: UUCP status inquiry and . . 
uusub: Monitor UUCP network. . . 

uuto, uupick: Public 

uutry: try to contact remote . . . 
uux: Executes command on remote 

uuxqt limit file 

val: Validates an SCCS file. . . . 

Validates an SCCS file 

validity of program 

value, false: 

value 

value machid: machid 

value 

value, floor, ceiling and/ /fabs, . . 
value for environment name. . . . 

value of a long integer 

value of a tunable parameter . . . 

value to environment 

values . 

values: machine-dependent values 
values of tunable parameters . . . 

varargs argument list 

varargs: variable argument list. . . 

fix a virtual disk 

variable 



uuclean(ADM) 

rmail(ADM) 

uuinstall(ADM) 

devices(F) 

dialcodes(F) 

dialers(F) 

uucheck(ADM) 

uusched(ADM) 

maxuuscheds(F) 

maxuuxqts(F) 

uusub(Q 

permissions(F) 

poU(F) 

uulist(ADM) 

uuclean(ADM) 

uustat(Q 

sysfiles(F) 

systems(F) 

uuencode(C) 

uuencode(C) 

uugetty(ADM) 

uuinstall(ADM) 

uulist(ADM) 

uuto(C) 

maxuuscheds(F) 

uusched(ADM) 

uustat(Q 

uusub(C) 

uuto(C) 

uutry(ADM) 

uux(C) 

maxuuxqts(F) 

val(CP) 

val(CP) 

assert(S) 

false(C) 

abs(S) 

machid(C) 

true(C) 

floor(S) 

getenv(S) 

labs(DOS) 

idtune(ADM) 

putenv(S) 

values(M) 

values(M) 

sysdef(ADM) 

vprintf(S) 

varargs(S) 

vdutil(ADM) 

tz(M) 
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varargs: variable argument list varargs(S) 

edit: text editor (variant of ex for casual users) . . edit(C) 

vc: version control vc(C) 

Gets option letter from argument vector, getopt: getopt(S) 

the/ /displays the list of vectors currently specified in . . . vectorsinuse(ADM) 

of vectors currently specified/ vectorsinuse: displays the list . . vectorsinuse(ADM) 

display editor, vi, view, vedit: Invokes a screen-oriented . vi(Q 

chcckaddr: MMDF address verification program ...... checkaddr(ADM) 

isverify: verifies ISAM database entries . . isverify(M) 

assert: Helps verify validity of program assert(S) 

vc: version control vc(C) 

red: Invokes a restricted version of. red(C) 

scesdilf. Compares two versions of an SCCS file scesdifB^CP) 

formatted output of a/ vprintf, vfprintf, vsprintf: Prints vprintf(S) 

screen-oriented display editor, vi, view, vedit: Invokes a .... vi(C) 
a binary file for transmission via mail uudecode: decode . . . uuencode(C) 

a binary file for transmission via mail uuencode: encode . . . uuencode(C) 

submit remote mail received via UUCP rmail: rmail(ADM) 

the font and video mode for a video device, vidi: Sets vidi(C) 

vidi: Sets the font and video mode for a video device. . . vidi(C) 
mode for a video device, vidi: Sets the font and video . . . vidi(C) 

screen-oriented display/ vi, view, vedit: Invokes a vi(C) 

add.vd: add a virtual disk add.vd(ADM) 

vdinfo: virtual disk information utility . . vdinfo(ADM) 

vdutil: virtual disk add vdutil(ADM) 

del.vd: delete a virtual disk del.vd(ADM) 

vdinfo: display virtual disk information vdinfo(ADM) 

vddaemon: virtual disk initialization .... vddaemon(ADM) 

vmstat. Reports virtual memory statistics vmstat(C) 

statistics, vmstat: Reports virtual memory . . vmstat(C) 

UNIX file system volcopy: make literal copy of . . . volcopy(ADM) 

- format of UNIX system volume fs: file system fs(F) 

file system: Format of a system volume filesystem(F) 

Prints formatted output of a/ vprintf, vfprintf, vsprintf: .... vprintf(S) 

output of a/ vprintf, vfprintf, vsprintf: Prints formatted .... vprintf(S) 
who is on the system and what w: Displays information about . . w(C) 
background processes, wait: Awaits completion of ... wait(C) 

event. ev_block: Wait until the queue contains an . ev_block(S) 

to stop or terminate, wait: Waits for a child process . . wait(S) 

sigsem: Signals a process waiting on a semaphore sigsem(S) 

stop or terminate, wait: Waits for a child process to . . . wait(S) 
checks access to a resource/ waitsem, nbwaitsem: Awaits and . waitsem(S) 

ftw: Walks a file tree ftw(S) 

wall: Writes to all users wall(ADM) 

characters, wc: Counts lines, words and . . . wc(C) 

whodo: Determines who is doing what whodo(C) 

what, whodo: Determines who is doing . whodo(C) 

jagent: host control of windowing terminal jagent(M) 

jterm: reset layer of windowing terminal jterm(C) 

ismpx: return windowing terminal state .... ismpx(C) 

/protocol used between host and windowing terminal under .... layers(M) 
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layers: layer multiplexer for 
multiplexed tty driver for AT&T 
Scan the spool directory for 
Get the pathname of current 
cd: Changes 
chdir: Changes the 
pwd: Prints 
fputc, fputchar: 



ouQ): 

console, putch: 
putpwent: 
write: 
wall: 
write: 

a file for shared reading and 
a file region for reading or 
open: Opens file for reading or 
the 5620 DMD terminal 
utmp, wtmp: Fonnats of utmp and 
entries, utmp, 
accounting/ fwtmp: fwtmp, 

commands, 
incremental filesystem backup, 
uux: Executes command on remote 
/add new user accounts given a 
x286emul: emulate 
Assembler, asx: 
masm: Invokes the 
boot: 

intro: Introduces 
commands, intro: Introduces 
Convert 386 COFF files to 
filesystem/ xbackup: Performs 
system/ xrestore: Invokes 
xinstall: 

netutil: Administers the 
Executes commands on a remote 
Prints the name of the current 
config: Configures a 
cu: Calls another 
uname: Gets name of current 
rep: Copies files across 
dosld: 

mmdfalias: converts 
to/ mnlist: converts a 
file to/ uulist: converts a 
uuto, uupick: Public 
shell script 



windowing terminals 

windowing terminals xt: .... 

work, uucico: 

working directory, getewd: . . . 

working directory 

working directory 

working directory name 

Write a character to a stream. . . . 

write: Writes to a file 

write: Writes to another user. . . . 
Writes a byte to an output port. . . 

Writes a character to the 

Writes a password file entry. . . . 

Writes to a file 

Writes to all users 

Writes to another user. 

writing, sopen: Opens 

writing. /Locks or unlocks .... 

writing 

wtinit: object downloader for . . . 

wtmp entries 

wtmp: Formats of utmp and wtmp . 
wtmpfix: manipulate connect . . . 
x286emul: emulate XENIX 80286 . 
xargs: Constructs and executes . . 
xbackup: Performs XENIX .... 

XENIX 

XENIX-style password file . . . 

XENIX 80286 . 

XENIX 8086/186/286/386 . . . . 

XENIX assembler. 

XENIX boot program 

XENIX commands 

XENIX Development System . . 
XENIX format, coffconv: . . . . 

XENIX incremental 

XENIX incremental file 

XENIX installation shell script . . 

XENIX network 

XENIX system, remote: . . . . 

XENIX system, uname: 

XENIX system 

XENIX system 

XENIX system 

XENIX systems 

XENIX to MS-DOS cross linker. 
XENIX-style aliases file to/ ... 
XENIX-style Micnet routing file 
XENIX-style UUCP routing . . . 
XENIX-to-XENIX file copy. . . . 
xinstall: XENIX installation . . . 



layers(C) 

xt(HW) 

uucico(C) 

getcwd(S) 

cd(C) 

chdir(S) 

pwd(C) 

fjputc(DOS) 

write(S) 

write(C) 

outp(DOS) 

putch(DOS) 

putpwent(S) 

write(S) 

wall(ADM) 

write(C) 

sopen(DOS) 

locking(S) 

open(S) 

wtinit(ADM) 

utmp(F) 

utmp(F) 

fwtmp(ADM) 

x286emul(C) 

xargs(C) 

xbackup(ADM) 

uux(C) 

addxusers(ADM) 

x286emul(C) 

asx(CP) 

masm(CP) 

boot(HW) 

Intro(C) 

Intro(CP) 

cofftx)nv(M) 

xbackup(ADM) 

xrestore(ADM) 

xinstall(ADM) 

netutil(ADM) 

remote(C) 

uname(C) 

config(ADM) 

cu(C) 

uname(S) 

rcp(C) 

dosld(CP) 

mmdfalias(ADM) 

mnlist(ADM) 

uulist(ADM) 

uuto(C) 

xinstall(ADM) 
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entries from files, xlist, fxlist: Gets name list .... xlist(S) 

programs, xref: Cross-references C xref(CP) 

incremental file system/ xrestore: Invokes XENIX .... xrestore(ADM) 
programs, xstr: Extracts strings from C ... xstr(CP) 

xtt: extract and print xt driver packet traces xtt(ADM) 

xts: extract and print xt driver statistics xts(ADM) 

AT&T windowing terminals xt: multiplexed tty driver for . . . xt(HW) 

channels protocol used by xt(7) driver /multiplexed .... xtproto(M) 
protocol used by x t (7)/ xtproto: multiplex^ channels . . xtproto(M) 
statistics xts: extract and print xt driver . . xts(ADM) 

packet traces xtt: extract and print xt driver . . xtt( ADM) 

functions, bessel, jO, jl, jn, yO,yl,yn: Perfonns Bessel . . . bessel(S) 

bessel, jO,jl,jn, yO, yl,yn: Performs Bessel/ bessel(S) 

compiler-compiler, yacc: Invokes a yacc(CP) 

yes: Prints string repeatedly. . . . yes(C) 

bessel, jO, j 1 , jn, yO, y 1 , yn: Performs Bessel functions. . . bessel(S) 

zcat: Display a stored file compress(C) 

true: Returns with a zero exit value true(C) 

set default system time zone timezone: timezone(F) 

TZ:Time zone environment variable. . . . tz(M) 
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Change Information 

This is a summary of the changes that have been made to the previous 
version of this manual. The chapters, page numbers, and/or paragraphs 
mentioned in this summary refer to the previous manual. 

Title: Altos UNIX System V/386 Release 3.2 
User’s Reference (C,M,F) 

Revised Part Number: 690-23414-002 

Previous Part Numbers: 690-23414-001 and 690-24536-001 

Date: March 1991 



Changes: 

The phrase, “for the 486” (or in some manuals “for Entry-level Sys- 
tems”) was deleted to indicate that this operating system runs on a wider 
range of platforms. 

The “Guide to Your Altos UNIX System V/386 Release 3.2 Documenta- 
tion” and the “Operating System Documents for Different Audiences” 
pages located in the front matter of the manual were both changed to indi- 
cate that a different combination of the available manuals are now 
shipped with every run-time system. This has also affected which manu- 
als are now available as spare parts. 

Added fuser(C)y hostid(C\ ksh(C\ otariC), pscat{C\ rcvtrip(C), 
setmode(C), xprcat(C), isverify(M), powerfail(b^, restart(M), 
cardJnfo(¥), hs(F), maildelivery(F\ meisa(F), memtune(F\ and 
xprtab^). 

Deleted ct(C). 

Miscellaneous editing and typographical changes were made throughout 
the manual. 



Change Information 



CH-1 




Change Information 



Page Command Description 



1 

1 

3 

1 

1 



6 

1 



1,5 

1,2 

1 



1-5 



2 



cpio(C) 

date(C) 

dd(C) 

devnm(C) 

dos(C) 

dos(C) 

echo(C) 



man(C) 

more(C) 

newform(C) 

passwd(C) 



ps(C) 



Added -T and -K options. 

Added -c, -m, and -s options. 

Corrected block size used in example, from 1 K 
to 512-byte blocks 

Corrected disk device reference, from hdl to 
hdb. 

Inserted description of dos{C) utilities, which 
was mistakenly omitted from some versions of 
the document. 

Corrected disk device references, from rhdOd 
and rhdld to rhdad and rhdbd respectively. 

Added -n option. Removed the note detailing 
dififemeces between csh built-in echo and 
Ibinlecho. Added a note describing how to 
echo octal characters. Removed “Standards 
Conformance” section. 

Deleted CT designator references, and 

emphasized that nroffitxi processing package 
must be installed separately. 

Deleted -r option. 

Added more information clarifying the use of 
the -1 option. 

Substantially revised the description of passwd. 
This includ^ changing valid options and argu- 
ments, and adding new settings to 

/etc/default/passwd. Also, removed the “Stan- 
dards Conformance” section. 

Deleted -s option, for specifying an alternate 
swap file. 
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Page 


Command 


Description 


1 


sddate(C) 


Corrected hard disk device file example, from 
rhdO to rhda. 


2 


stty(C) 


Added a note that the dsrflow option to control 
DSR output flow is valid for only non-modem 
lines (i.e., when clocal is also set). 


5 


tar(C) 


Corrected blcok size used in example from 1 K 
to 512-byte blocks. 


1-4 


tset(C) 


Simplified description of tset options. 


1-3 


getty(M) 


Added -g and -b options. 


2 


init(M) 


Replaced description of /etc/inittab with 
description of DEFAULT_LEVEL variable in 
/etc/default/boot. 


1-3 


login(M) 


Added new definitions in /etc/default/login 
that login checks. Also added many explana- 
tions of disgnostics messages that may appear 
during login attempts. 


3 


inittab(F) 


Added restart action keyword. 


1.2 


mdevice(F) 


Added numerous driver function characters, 
and new characteristics identifiers. 


1.4,5 


term(F) 


Deleted (CT) designator references to nroffmd 
related commands. Added a reminder that the 
family of text processing utilities must be 
purchased spearately. 
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